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Introduction 


Working with RT—11 introduces you to the components and 
functions of RT—11—a single-user, real-time operating sys- 
tem that can handle multiple tasks. This book assumes that 
you have previous experience working at a computer ter- 
minal with an operating system other than RT—11, that you 
understand how a computer works, and that you are famil- 
iar with terms such as bit, byte, word, and file. 

The first three chapters of Working with RT—11 deal 
with system organization. Chapter 1, “Identifying RT—11 
Components,” examines the hardware requirements and 
software components of an RT—11 system. Particular atten- 
tion is paid to major monitor components. Chapter 2, ‘‘Get- 
ting Started,”’ puts you at the terminal to begin working with 
the keyboard, getting HELP, and using some essential con- 
trol characters. Chapter 3, “Storing Data on Disks,’ de- 
scribes how file storage is organized, how files are speci- 
fied, and how information in files can be manipulated using 
simple commands. 

Two chapters examine the editors most often used on 
RT-—11 systems. Chapter 4, “Using KED to Edit Text Files,” 
explains how to use a screen editor to create and edit text 
files. Chapter 5, ‘‘Editing and Issuing Monitor Commands,” 
discusses the single line editor used to modify command 
lines, and describes how to issue commands using Digital 
Command Language (DCL), Command String Interpreter 
(CSI), and Concise Command Language (CCL). 
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The flexibility of the RT~—11 system for programming 
and using prepared applications is pointed up in the next 
two chapters. Chapter 6, “Using Utility Programs,’ de- 
scribes the functions of utility programs and shows how to 
call up utilities with DCL commands. Chapter 7, ‘“‘Devel- 
oping Programs,” tells you how to use the RT-11 system 
to create, compile, and run a program. 

The last two chapters in the book focus on ways to save 
you time and make the most efficient use of space in your 
files. Chapter 8, “Creating Files of Commands,”’ details the 
creation and function of indirect command files and indi- 
rect control files. Chapter 9, ‘“‘Conserving Space with De- 
vice Support,”’ tells you how to make use of virtual mem- 
ory and how to create and mount logical disks. 

When you have read the chapters and completed the 
practices, you will be familiar with the organization of the 
RT-11 system. You will be confident in using DCL com- 
mands to operate on files and in accessing the system util- 
ities to edit and run your own programs. And you will be 
able to use indirect files to process sequences of monitor 
commands. 


Learning Approach 


After you have read the introduction and the chapter text, 
complete any practices. Many practices are not designed to 
have right or wrong answers but to give you experience 
working with your RT—11 system. Answers to practices that 
require them are provided near the end of the chapter. If 
you need further study before moving on to the next chap- 
ter, read the materials suggested at the end of the chapter, 
then review the chapter from the beginning. 

To become familiar with RT—11, you should spend at 
least half a day at a time reading and working with the sys- 
tem and not allow more than a week between work ses- 
sions. You should try to finish the material covered in this 
book within two weeks. 

If possible, you should work in a quiet area away from 
telephones and other interruptions, with space for your 
terminal, and enough desk space to have two or three man- 
uals open at the same time. 
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Equipment 


You will need access to a working RT—11 system. By a 
working system, we mean that: 


e The RT—11 monitor program has been transferred 
from its storage disk to main memory (in other 
words, the system has been bootstrapped) 


e The language processing program for FORTRAN IV 
or BASIC—11 has been installed and made available 
for use 


e A storage medium—whether it is a disk cartridge, 
diskette, or magnetic tape—is available for the pro- 
grams you will create 


If you need to bootstrap your system, you may ask a 
colleague who has experience working with an RT—11 op- 
erating system for assistance. Table 1 lists the manuals that 
provide information on bootstrapping the computer sys- 
tems on which RT-11 runs. 


Table 1. 

Manuals with Bootstrapping Procedures 

System Manual 

Professional 300 RT-11 Automatic Installation Booklet: 
Professional 325/350 


System Release Notes 


MICRO/PDP-11 RT-11 Automatic Installation Booklet: 


MICRO/PDP-11 
PDP-11/23-Plus Introduction to RT-11, chapter 2 
[24 RT-11 Automatic Installation Booklet: 
/44 RX02 Diskettes 
RT-11 Automatic Installation Booklet: 
RLO2 Disk 


RT-11 Installation Guide 


PDP-11 Introduction to RT-11, appendix A 
(without automatic bootstrapping) —tz-77 Installation Guide 
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Resources 


Although every effort has been made to make Working with 
RT-—11 a self-contained volume, you may need to refer to 
the following manuals from the RT—11 documentation set 
for additional information: 


e Introduction to RT-11 

e RT-—11 System User’s Guide 

e RT-—11 System Utilities Manual 
¢ RT-—11 Software Support Manual 


The documentation to which we refer throughout the text 
is written for RT—11 version 5.0. We also used a computer 
system equipped with RT—11 version 5.0 to generate the 
programs in our examples and practices. If you own a newer 
version of RT—11, you may also need a copy of the latest 
System Release Notes to determine the difference between 
your system and the one described here. A list of manuals 
and books that provide supplementary information is in- 
cluded at the end of this book. 


Notations 


The following symbols are used in this book to represent 
specific elements: 


(KEY) indicates keyboard and keypad keys, their func- 
tions, or key combinations 


indicates the prompt displayed by the system 
monitor 


COMMANDS (uppercase) indicates input 
Prompts (upper and lowercase) indicates computer output 


[ ] indicates parts of a command that are optional 
(the brackets are not part of the command string) 
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The Terminal 
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The RT—11 Operating System 
The monitor 
Device handlers 
Utility programs 
Support for language processors 
Language Processors 
Assemblers 
Compilers 
Interpreters 
Applications Programs 
System Documentation 
Hardware Manuals 
Software Manuals 
Source Listings 
Summary 
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RT-11 
Components| 


This chapter describes the hardware and software compo- 
nents of a typical RT—11 computer system. The essential 
hardware components include a processor, a terminal, and 
a storage medium. The system software consists of the RT— 
11 operating system, language processors, and application 
programs. This chapter introduces you to the components 
of the RT—11 operating system—the monitor, the device 
handlers, the utility programs, and the support for lan- 
guage processors—as well as the components of the moni- 
tor—the Resident Monitor (RMON), the Keyboard Monitor 
(KMON), and the User Service Routine (USR). It discusses 
the three types of monitors available on RT—11 systems— 
the Single Job monitor (SJ), the Foreground/Background 
monitor (FB), and the Extended Memory monitor (XM). A 
list of the documentation written for RT—11 is provided near 
the end of the chapter. 
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System Hardware 


The Processor 


The Terminal 


RT-—11 is an operating system that will run on a number of 
computer systems. The minimum hardware configuration 
for an RT—11 system consists of a PDP—11, LSI—11, or SBC— 
11 processor, 32 Kbytes of main memory, one terminal, and 
a disk drive with disks or diskettes for mass storage and for 
backup. Larger systems may have a clock, more memory, 
more terminals, and more peripheral devices. Table 2 lists 
the minimum sets of components required to run RT-11. 


You can use an RT—11 operating system with a variety of 
PDP—11 processors, ranging in size from the single board 
LSI-11 to the PDP—11/44. 

You will notice different switches, lights, and buttons 
on the front panel of each PDP—11 computer. On a com- 
puter system running RT—11, these are used only to start 
the system. All further communication between you and the 
system is done through the terminal. 


You may use either a video or printing terminal as your in- 
put and output device. Generally, an RT—11 computer sys- 
tem has only one terminal, called the console terminal, 
through which all interaction between you and the system 
takes place. Additional terminals may provide auxiliary 
message-printing capabilities. 


The Storage Device 


Your RT—11 system allows you to use both cartridge and 
floppy disk drives and to have access to more than one disk 
or diskette on your system at a time. 
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Table 2. 
Minimum Hardware Requirements of an RT-11 System 
Minimum System Storage Console 
Processor Memory Device Device Terminal 
Professional 300 256K bytes RD51 RX50 Professional 
Integral 


MICRO/PDP-11 256K bytes RD51 RX50 


PDP-11 32K bytes RKO5 Magnetic VT100 LA12 


Unibus RKO6 Tape VT101 LA34 

11/04, 11/05, RKO7 RKO5 VT102 LA38 

11/10, 11/20, RLO1 -RLO1 VT105 LA100 

11/24, 11/25, RLO2 RLO2 VT125 LA120 

11/35, 11/40, RX01 RX01 VT131 

11/44, 11/45, RX02 RX02 

11/50, 11/55, 

11/60, 

PDT 11/150 

PDP-11/03 32K bytes RKO5 RKO5S VT100 LA12 

(LSI-11) RLO1 RLO1 VT101 LA34 
RLO2 RLO2 VT102 LA38 
RX01 RX01 VT105 LA100 
RX02 RxX02 VT125 LA120 

VT131 

PDP-11/23 64K bytes RLO1 RLO1 

PDP-11/23- RLO2 RLo2 

PLUS RxX02 RX02 


A disk or diskette—also called mass storage medium 
or volume—provides an area, apart from main memory, to 
keep information. The information may be the programs that 
make up the system software, applications programs, pro- 
grams you create, data needed by a program, the results of 
a computer operation, or textual information. The RT-—11 
operating system, for instance, is stored on a storage me- 
dium referred to as the system volume. When needed, in- 
formation from the storage medium is transferred into 
computer memory. 

To access information that is stored, you must insert 
the storage medium (disk or diskette) into a drive. Each drive 
is assigned a device name (a mnemonic) and a unit number 
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(0, 1, 2 etc.). Once the disk is inserted into the drive, the 
disk drive’s symbol identifies the storage volume. 

One way to protect information on a disk is to make a 
copy of it on a second storage volume. The copy, called a 
backup, insures you against the loss of information. Some 
storage volumes provide a mechanism that protects infor- 
mation against accidental erasure. This mechanism is gen- 
erally a switch—on the disk itself or on the drive—that you 
can set to write-protect or write-enable. You can protect a 
floppy diskette by covering its write-enable notch with a 
metallic sticker. (Disks and the files that they may contain 
are discussed in chapter 3, “Storing Data on Disks.’’) 


Optional Hardware 


The specific requirements of certain users may dictate the 
need for additional peripheral devices. For example, com- 
puter systems used mainly for program development may 
need extra storage devices and a high-speed printer. Com- 
puter systems used in a laboratory may need graphics dis- 
play hardware, and computer systems that provide infor- 
mation in conjunction with another kind of computer system 
will usually require a magnetic tape device, because mag- 
netic tape is a standard storage device across the industry. 
Smaller PDP—11 systems, such as the MICRO/PDP—11 and 
the Professional computers, cannot accommodate as much 
additional hardware as larger systems. 


System Software 


Your system software is the set of programs that transforms 
your hardware components into usable tools. Some of these 
programs store and retrieve data among various peripheral 
devices. Others perform difficult or lengthy mathematical 
calculations. Some programs allow you to create, edit, and 
process application programs of your own, and others han- 
dle applications for you. 

The system software, as illustrated in figure 1, in- 
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Figure 1. 
System Software 


_ RT-11 
OPERATING 
SYSTEM 


LANGUAGE 
PROCESSORS 


APPLICATION 
PROGRAMS 


cludes the RT—11 operating system, which is the ‘“‘intelli- 
gence”’ of the computer system. In addition, your system 
software probably includes one or more language proces- 
sors and possibly specific applications as well. 


The RT—11 Operating System 


The operating system is a collection of programs that or- 
ganizes all the hardware and software resources of the 
computer system into a working unit and gives you con- 
trol. It allows you to create and run programs of your own. 
The RT—11 operating system is made up of four types 
of programs: the monitor program for control of system op- 
eration; several device handlers, one program for each of 
the supported hardware devices; a variety of utility pro- 
grams for program and data creation and manipulation; and 
the collections of programs that are necessary to support 
several programming language processors (see figure 2). 
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Figure 2. 
RT-11 Operating System 
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The Monitor 


Your link with the system hardware and software is the 
monitor, and the RT—11 monitor provides many different 
subprograms or routines which work together to perform 
basic system functions. These functions include the fol- 
lowing: 


e Acceptance, acknowledgement, and processing of 
commands that you, or a program, may issue to the 
system 


¢ Control of all input and output to and from the sys- 
tem 


e Timing, or scheduling, of when jobs (programs) 
should run 


e Maintenance of system files 


¢ Checking for abnormal conditions within the system 
and issuing clear, informative messages 


¢ Control of the way memory is used by the system 


The three main parts of the monitor that perform these 
and other functions are, the Resident Monitor (RMON), the 
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Keyboard Monitor (KMON), and the User Service Routine 
(USR). 

The Resident Monitor (RMON) provides the console 
terminal service and central program code necessary for both 
system and user programs. When RT-11 is started, RMON 
is automatically loaded from disk storage into processor 
memory, where it stays until the system is closed down or 
restarted. The resident monitor is so named because it al- 
ways remains in computer memory, regardless of system 
operations. To tell you that it has been loaded and started, 
RMON issues a message to the terminal. 


EXAMPLE 


isan ales ile titel SSE erates obit 


— RT-11SN €S) VOS.00 


rp POPC 8 NN RENE 


premises 
f 


isin aa bisa saben Nom vita id Satta nth SR Sn ni Ahn to ROE HF ERAN i abit i NH RW AEE a Nas Sa a 8 A OA NE ASB NE 


Note that the message is made up of more than one part. 


RT-11 The name of the operating system. 


SJ The abbreviation for Single Job. This describes 
the specific type of monitor you are using. You 
may also see FB or XM appear here to indicate 
that you are using a Foreground/Background or 
Extended Memory monitor. 


(S) The abbreviation for system generation, the 
term used to describe the building of an operat- 
ing system from its component parts. System 
generation can be performed by those users who 
wish to create a tailor-made operating system, 
but RT—11 comes in ready-to-use form. 


V05.00 The version number of the monitor currently 
being used. This number may be different on 
your system, because as additions or changes 
are made to the system the number is corrected 
to show the current revision level. 


You will see that the message is followed by a period 
(.) on the next line. This is called a system prompt or dot 
prompt and indicates that the monitor is waiting for you to 
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issue a command. The dot prompt is sent to the terminal 
by the Keyboard Monitor. 

The Keyboard Monitor (KMON) controls the interac- 
tion between the monitor and keyboard and is the most 
visible part of the system software from your point of view. 
Among other services, KMON supplies the monitor com- 
mand language, a set of command words, that you use to 
initiate and control system operations. KMON is loaded into 
memory when needed and processes user commands. Be- 
cause you will need it only when commands are issued, 
KMON does riot stay in memory but is replaced or ‘‘over- 
laid” by other programs. KMON is swapped in and out of 
main memory so quickly that you will not notice the activ- 
ity as you type at the terminal. 

The User Service Routine (USR) is used to access in- 
formation stored on disks and tapes. Once it has finished 
its work, the USR can be overlaid in the same way as KMON. 
However, because you will probably handle information kept 
on a storage medium more often than you will process sys- 
tem commands, you may find it more efficient to keep the 
USR in main memory at all times. You can instruct the sys- 
tem to keep the USR permanently in memory by using the 
SET command. 


ee a ea ee ae ee en 
EXAMPLE ae ee ee | 


SET USR NOSHAPCETUM), eee | 


Ss 
ee 
Ee 
Ee 


See Sica a ei Sn PI dn Sine Ne a Ra ii Ss aS Dt oS te ak HM a ASE RBI Bi ES HIRE SRN BRE hat MOOS A 


RT-—11 provides three different kinds of monitors, each 
with its own RMON, KMON, and USR. The three monitors 
are Single Job (SJ), Foreground/Background (FB), and Ex- 
tended Memory (XM). 

The Single Job (SJ) monitor is the simplest and small- 
est monitor. The resident portion occupies only 4 Kbytes 
of main memory and therefore leaves most of the memory 
free for other programs and data. It can support one user 
program or system utility program and is ideal for smaller 
systems (sometimes called dedicated systems) which are 
being used for one specific application, such as scientific 
data logging or process control. The SJ monitor is not avail- 
able on the Professional 325 or 350. 
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A special version of the SJ monitor, the Base Line (BL) 
monitor, also runs in a minimum configuration of 32 Kbytes 
of memory, but it does not support optional monitor and 
device functions. The BL monitor is best suited for very 
small hardware configurations or for larger configurations in 
which the application requires minimal executive support. 

The Foreground/Background (FB) monitor has all the 
capabilities of the Single Job monitor as well as its own 
features. Many applications call for a high priority pro- 
gram, such as data collection, and a lower priority data 
analysis program. The Foreground/Background monitor al- 
lows two programs to run at the same time. The high prior- 
ity job is known as the foreground job and the low priority 
job is known as the background job. Since the FB monitor 
handles multiple jobs, you can work at the keyboard while 
the system processes another job. 

The PDP-—11 family contains processors which will 
support up to 4092 Kbytes of memory. The Extended Mem- 
ory (XM) monitor allows you to make use of that memory 
and allows jobs to be 128 Kbytes in size. The facilities of 
the Foreground/Background monitor and the Single Job 
monitor are still available with the XM monitor. 


Device Handlers 


Device handlers are programs that transmit control signals 
and data to and from your system’s peripheral hardware 
components. These programs check each device for errors, 
which they then report to the monitor for action. For ex- 
ample, the program which looks after the line printer checks 
that the printer is on and that it has paper in it. The pro- 
gram also makes sure that any necessary control characters 
are transmitted and that the characters for printing are valid. 
You will not come in contact with the device handlers ex- 
cept when the monitor asks you to make a correction, for 
example, to load paper as a result of the device handler’s 
check. 


Utility Programs 


RT-11 provides a number of utility programs that allow you 
to store data on a variety of devices, develop your own pro- 
grams, and manage the system. Among the utility programs 
to be discussed are the following: 
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e An editor, which allows you to create and change 
memos, programs, and documents 


¢ Debugging programs which help you uncover and 
correct errors in your programs 


¢ File maintenance programs which allow you to ma- 
nipulate the information contained in files or on de- 
vices 


¢ A librarian, which makes it easy for you to store and 
retrieve frequently used programming routines 


e A linking program, which converts programs into a 
format suitable for loading and execution 


e« A source comparison program, which is used to com- 
pare text files and to report any differences 


¢ A dump program, which outputs to the terminal or 
line printer the binary representation of any part of a 
file 


Many of the utility programs may be used by means of sim- 
ple, easy-to-learn commands. 


Support for Language Processors 


Two language processor support programs are available as 
part of the RT—11 operating system. The FORTRAN IV 
System Subroutine Library (SYSLIB) allows a FORTRAN IV 
user to write almost all application programs completely in 
FORTRAN IV with no assembly language coding. The other 
language processor support program is SYSMAC, the macro 
library that contains system macros used in assembly lan- 
guage, in this case MACRO-11, programs. 


Language Processors 


Language processors are translation programs that convert 
the programs you create at the terminal into a series of bi- 
nary codes that the computer can understand. They also 
translate binary codes back into words for output on a video 
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or printing terminal. A language processor exists for every 
programming language supported by the system, whether 
it is a high-level language or an assembly language. 


Assemblers 


Assemblers translate assembly language into object code, 
a language that the machine can execute. An assembler 
is a one-for-one translator; that is, each instruction in as- 
sembly language becomes an instruction to the computer. 
The assembly language on PDP—11 computers is called 
MACRO-11. Though MACRO-11 programs are slower to 
code and compile than programs written in high-level lan- 
guages, assembly language gives you more control over fac- 
tors such as program size and speed of execution. 


Compilers 


Compilers process high-level languages such as FORTRAN 
IV and COBOL-—11. Whereas assemblers translate one lan- 
guage instruction into one object code, compilers may 
translate one language instruction into many object codes. 
For example, a single FORTRAN command may be com- 
piled into twenty or more machine instructions. Though this 
coding process is faster than that of an assembler, you must 
relinquish some control over program execution. 

Most compilers do not translate the source or lan- 
guage code until it passes through the entire program at least 
once. Such multipass compilation—called code optimiza- 
tion—allows the compiler to eliminate unnecessary code and 
to check for errors at many levels. 


Interpreters 


Interpreters translate instructions written in a high-level 
language, such as BASIC—11, into a format the computer 
can interpret. Rather than converting the entire program to 
object code before running it, an interpreter translates and 
executes a program on a statement-by-statement basis. 
Though interpreted programs run slowly, using an inter- 
preter may enhance program development since you can 
receive an immediate response from the computer when 
errors in a program are detected. 
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Applications Programs 


The RT-—11 operating system supports numerous applica- 
tions packages. These include an applications package for 
the standard functions found in most laboratories. A sci- 
entific package for FORTRAN IV users provides a large se- 
lection of mathematical and statistical routines commonly 
required in scientific programming. And a graphics sup- 
port package for BASIC—11 and FORTRAN IV users pro- 
vides display features such as multiple intensity and blink- 
ing vectors (lines), alphanumerics, and points. In addition, 
during RT—11’s ten-year history, scores of real-time and 
commercial applications have been written by original 
equipment manufacturers (OEMs) and customers for use 
with RT—11 systems. Table 3 lists the names of some widely- 
used applications programs written for RT—11. 


Table 3. 
Applications Packages for RT-11 

Applications 
Word Processing LEX-11 


Glenn A. Barber Associates WPS 
WP Saturn Word/List Processing 
MASS-11 


Electronic Spreadsheet Saturn CALC 
C-Calc 
CALC-11 
Super Comp 


Time-sharing CTS-300 
TSX-Plus 
SHARE-11 


Sorting ZSORT 
RTSORT 


Database Management RT-DBASE 
“D” 
RTFILE 
SIMILE 
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System Documentation 


Documentation includes manuals that tell you how to use 
the software and hardware of the computer system. It also 
includes any source listings of programs that make up the 
operating system. 


Hardware Manuals 


Hardware manuals describe the devices in the computer 
system. RT—11 hardware documentation includes a pro- 
cessor handbook that describes the PDP—11 computer you 
are using, and a user’s guide or maintenance manual for each 
peripheral device in your computer system. These manuals 
tell you how to operate the devices and give you special 
programming information that you may need if you intend 
to write device drivers or special system software involv- 
ing the devices. 


Software Manuals 


Source Listings 


Software manuals describe the operating system and the 
language processors. RT—11 software documentation con- 
sists of introductory manuals (intended to be used once and 
then stored away), console manuals (intended to be used at 
the computer), and reference manuals (intended to be used 
at your desk for reference). Table 4 lists the introductory, 
console, and reference manuals available for RT—11. 


Source listings are actual listings of the assembly language 
codes that make up the RT—11 operating system. These 
listings are very detailed and generally are needed only if 
you intend to modify the system software. 
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Table 4. 
Documentation for RT-11 
Manuals 
Introductory Introduction to RT-11 


System Release Notes 


Console System User's Guide 
System Utilities Manual 
System Message Manual 


Reference Programmer's Reference Manual 
Software Support Manual 
MACRO-11 Language Reference Manual 


Summary 


MINIMUM HARDWARE CONFIGURATION 


PDP—11, LSI—11, or SBC—11 Processor 
32 KBytes of Main Memory 

One Terminal 

One Storage Device 


COMPONENTS OF SYSTEM SOFTWARE 


RT-—11 Operating System 
Language Processors 
Applications Programs 


COMPONENTS OF THE RT—11 OPERATING SYSTEM 


Monitor 
Types 
1. Single Job (SJ) 
2. Foreground/Background (FB) 
3. Extended Memory (XM) 
Components 
1. Resident Monitor (RMON) 
2. Keyboard Monitor (KMON) 
3. User Service Routine (USR) 
Device Handlers 
Utility Programs 
Support for Language Processors 
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Working with the Keyboard 
Monitor Commands 
Correcting Typing Mistakes 
Using the HELP Command 
Using Special Key Combinations 
Setting the Date and Time 
Type-Ahead Function 
Summary 


Getting 
Started 


This chapter puts you at the keyboard of your computer 
terminal to begin using your RT—11 operating system. To 
become familiar with the keyboard and monitor, you will 
work with some simple monitor commands. You will learn 
to issue commands that call up the HELP text and use spe- 
cial characters to stop and start a listing, suppress output, 
abort a job, and delete text. You will also learn to set the 
system’s clock and date-tracking device. 
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Working with the Keyboard 


All terminals have a keyboard—used to enter informa- 
tion—and a paper output device or video screen—used to 
echo characters typed at the keyboard and to print system 
messages and responses. The paper printer and the screen 
serve the same purpose; they show your input and the sys- 
tem’s responses. However, paper output can be saved while 
screen output is temporary. 

You type all commands to the system on the key- 
board. Figures 3 and 4 show the layout of the VT100 and 
the Professional 300 keyboards. The keys for the alphabetic 
characters, the (snirt), (caps Lock), and (as) keys work and are ar- 
ranged in the same way as those on most standard type- 
writers. Table 5 describes the functions of some keys you 
will use often. 


Table 5. 

Keys and Their Functions 

Symbol* Key Function 

(RETURN) Carriage Return Ends a line and moves cursor to the 
next line 


Ends certain system commands, 
transmits them to the processor, and 
moves the cursor to the beginning 
of the next line 


(CTRL) Control Forms two-key control commands 
that perform specific functions 
The system carries out the function 
as soon as you press (CTRL) and the 
other key simultaneously 


(DELETE) Delete Erases the character to the left of the 
cursor 
(LINEFEED) Linefeed Ends certain system commands, 


transmits them to the computer, and 
moves the cursor to the beginning 
of the next line 


“This symbol the label on or function of a key enclosed in angle brackets—is used 
throughout the book to represent a key or its function. 


TZ 


KBD 
ONLINE OFFLINE LOCKED CTS DSR INSERT 


. O Ca © pee © ae © ae © O 
SET UP SET/ CLEARALL ON/OFF SETUP TOGGLE TRANSMIT RECEIVE 80/132 4 v < > 
CLEAR TAB TABS LINE A/B 0 SPEED SPEED COLUMNS RESET 
Esc @ A & ( + | BACK. I ereak 7 


ENTER 
LINE 


Figure 3. Keyboard Layout of the VT100 Terminal 
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Monitor Commands 


Monitor commands are words or letters you type in at the 
terminal after the period (.) monitor prompt to start up and 
control system operations. When you enter a command, you 
are communicating with the monitor program described in 
chapter 1. 

To issue a monitor command that the computer will 
accept, you must supply the following information: 


¢ The command for the system operation you want ini- 
tiated. It may be followed by a slash and a command 
option which modifies the default operation (the ac- 
tion RT—11 normally takes) 


¢ The input information—the location (indicated by a 
device name, a file name, and a file type) of the data 
that is to be processed. 


¢ The output information—the location (indicated by a 
device name, a file name, and a file type) where the 
information produced by the operation is to be stored 
(chapter 3, ‘Storing Data on Disks,” discusses file 
specifications) 


Whenever you type a command, the last key that you 
press must be the (return) key. return) will be shown at the 
end of commands throughout this book to indicate input 
and to remind you that it is necessary. 

Monitor commands may be written in either long for- 
mat or short format. For long format commands, the system 
displays prompt messages, which ask for all the informa- 
tion the command needs to be completed. For short format 
commands, you enter all the information in one command 
line. The monitor provides prompts only if you leave out 
essential information. Short format commands are pre- 
ferred by experienced users, while long format commands 
are useful for beginners. 


€7% 


Insert @ Re- 
Here § move 
Prev ext 
ScreenfScreen| 


Compose 
Character 


Figure 4. Keyboard Layout of the Professional 300 Terminal 
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The meaning of the COPY command will be explained 
later; for now, just compare the long and short formats of 
the command. In this chapter we will examine several 
commands just to see RT—11 in action. 


Correcting Typing Mistakes 


Practice 
2—1 


If you make a mistake while typing a command, you can 
correct it by using either the (etetty key (labeled <4 on the 
Professional keyboard) or the «ctruu) key combination. 

(peteTe) erases Characters from right to left, starting with 
the last character typed. Each time you press (octets), it erases 
one character to the left of the cursor. (ve.ete) can only re- 
move characters from the current line of typing, that is, be- 
fore you Press (RETURN). 

(ctruu) deletes all the characters on the current line and 
moves the cursor to the beginning of a new line so that you 
can enter the next character or command. cctauv) is dis- 
played on your terminal as * U. 


1. If you are using a video display terminal with the Sin- 
gle Job monitor, type: 


SET TT SCOPE RETURN) 
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after the period monitor prompt. SET TT SCOPE tells 
RT-11 that your terminal is a video rather than a 
printing terminal. 


Type the letters: 
MISTAEK 


Do not press (RETURN). Once you press the (RETURN) OF (LINE- 
FEED) key, you will not be able to erase the characters. 


To erase the transposed letters, press: 
(DELETE)(DELETE) 

You may then type in the letters: 

KE 

Now use (cTrRUU) to erase the word: 


MISTAKE 


While you hold down (ctrl), press (uy. The two keys 
should be pressed simultaneously. All the characters 
will be erased. 


Using the HELP Command 


RT-—11 has a very useful feature called HELP. Whenever you 
have questions about the system, typing the HELP com- 
mand may very well provide or direct you to the answer. 
To see what commands are available, you would type the 
HELP command followed by an asterisk, press (return), and 
be provided with a list of commands (shown in figure 5). 
You need not memorize the commands you see since 
the list only shows the kinds of options that are available 
to you. If you need information about any of the topics listed, 
you can find it by typing HELP, followed by the name of 
the topic. For example, typing HELP SHOW will give you 
more details about the SHOW command (see figure 6). 
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Figure 5. 
HELP Listing 


ABORT 
ASSIGN 
kh 
BACKUP 
RASIC 
KOOT 
CLOSE 
COMPILE 
COFY 
CREATE 
ti 

LATE 
LIEASSIGN 
DELETE 
QIBOL 


QIFFERENCES 


NIRECTORY 
QISMOUNT 
QUMF 

KE 

EDIT 
EXECUTE 
FORMAT 
FORTRAN 
FF RUN 
GET 

GT 

HELF 
INITIALIZE 
ENSTALL 
LIBRARY 
LINK 
LOAD 
MACRO 
MOUNT 
PRINT 
PROTECT 
QUEMAN 
LN 
REENTER 
REMOVE 
RENAME 
RESET 
RESUME 
FUN 
SAVE 
SET 
SHOW 
SQUEEZE 
SRUN 
START 
SUSPEND 
TIME 
TYPE 
UNLOAT 
UNFROTECT 
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Terminates» from the system consoler a Foresround or 
Associates a losicel device mame with @ rhysical device 
Sets 8 relocation base 

Rackur/Restore large files or random access devices 
Invokes the BASIC lansguase interereter 

Roots 8&8 new system 

Makes backsround outeut files rermanent 

Translates source Frodrams 

Cories files 

Creates a file at a srecific block addresss extends 
terosits values im memory 

Sets or disrlays the current system date 

Removes losical device name assignments 

Removes files from a device or Queue 

Invokes the ITBCL lansuasde com-iler 

Comreares two files and lists the differences 

Lists device or file directories 

lisassociates a losical disk assismment from a file 
Frints formatted date dumes of files or devices 
Frints the contents of memory on the terminal 
Invokes the text editor 

Translates, links: and runs a erodram with one command 
Formats and/or verifies a volume 

Invokes the FORTRAN lansuasde comriler 

Loads and starts a foresround ev rogram 

Loads @ memory image file into memory 

Enables or disables the VT11 or VS60 disrlay hardware 
Lists helreful information 

Initializes device directories 

Adds 3 new device handler to the sustem 

Creates and alters obJect anc macro libraries 
Froduces an executable rrosram 

Mekes a device handler fermanently resident in memory 
Invokes the macro assembler 

Assigns @ lostical disk unit to a file 

Frints files on the line erinter 

Sets RT-11 file errotection status 

Queue control rrogram, 

Loads and executes 3 memory imase file 

Starts @ frrosram at its reentry acdress 

Removes a device handler from the system 

Changes the name of a file 

Causes 32 general sustem reset 

Resumes execution of a foreground or system Job 
Loads and starts 3 Frogram 

Writes memory areas to a file 

Comtrols various system ortions 

Nisrelays system hardware and software status 
Rearranses disk files to collect unused file sreace 
Loads and starts a sustem Job 

Initiates the rrodram in memory 

Storrs execution of the foresround or system Joh 

Sets or disrlays the system time 

Quteuts files to the terminal 

Removes 8 resident device handler or FG Job from memory 
Resets RT-11 file erotection status 


Figure 6. 
HELP Text for the SHOW Command 


HELF SHOW 
SHOW Disrelays sustem hardware and software status 


SYNTAX 
SHOW Cortions3 


SEMANTICS 
SHOWZCR> disrlays the device assignmentss other information 
is disrelayed by srecifying one or more ortion mames-e 


OF TIONS 
ALL 
Shows configurations devices, Jobsr, and terminals 
CONFIGURATION 
Indicates the monitor version mumberrSET ortiorns» 
hardware confisgurationsand SYSGEN ortions 
DEVICES 
Indicates the status and vectors of a@11 device handlers om the 
sustem 
ERRORSC/ortions J 
Froduces om the terminal a rerort of all system and device 
errors’ valid only if error logsins is rresent. Ortions ares 
7ALL. (default?) 
Froduces the rerort for all errors 
/FILEC 3 filnam.tyrd 
Srecifies the name of the file containing the lossed 
errorsy defaults to ERRLOG.DIAT 
/FROMi Cddimmms yy 
Rerorts only errors that occurred after the date 
srecified , 
/OUTPUT i filesrec 
Froduces the rerort in the srecified file 
“PRINTER 
Froduces the rerort on the line erinter 
/ SUMMARY 
Froduces 3 Summary rerort 
/ TERMINAL. (default) 
Froduces the rerort on the terminal 
/TOS Cad s mms yd 
Rerorts only errors that occurred before the date 
srecified 
JORS 
Lists the mames and status of a11 loaded Jobs 
MEMORY 
tiselays the current memory organization im tabular form 
QUEVEC/IEVICE? devi 
Lists the contents of the line rrinter (or srecified device) 


Queue 
SUBSET 

List the current losical disk subsetting assignments in effect 
TERMINALS 


Indicates the status and SET ortions of all the terminals on the 
system (Cif a multi-terminal monitor) 


EXAMPLES 
SHOW 
SHOW CONFIGURATION 
SHOW QUEUE 
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Practice After the period monitor prompt, enter the command: 


2-2 HELP (RETURN) 


and survey the listing to get an overview of the commands 
used with RT—11. 


Using Special Key Combinations 


Suppose you wanted to search the HELP * listing for a par- 
ticular command. You need to be able to stop and start the 
listing at intervals to do this search. To stop a listing, you 
can use the cctrusy key combination. To continue the listing, 
you can use the (crrua) key combination. ( oscrou) on the VT100 
terminal or (Ho.o screeny on the Professional terminal also al- 
lows you to stop and start a listing. You simply press the 
key once to stop a listing and press it again to continue the 
listing.) 

Another way to stop a listing while it is running is to 
use the cctrvo) key combination, which stops the listing being 
displayed on your terminal without stopping the program. 
If you press (ctrvo) a second time before the listing is com- 
pleted, the remaining parts of the listing will be displayed. 
To abort a program while it is running you press (ctruc) twice. 

You have already used one of the special key combi- 
nations, (craw). If you are using a display terminal, you should 
enter the command, SET TT NOSCOPE, before you try us- 
ing other special key combinations, so that listings do not 
stop when the screen is full. It is not essential to do this to 
use the special key combinations, but NOSCOPE makes it 
easier to see the effects of using the key combinations dis- 
cussed. 
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Practice . Type: 
= HELP (RETURN) 
after the dot prompt and try to stop and start the list- 
ing using the ctavs) and (ctrva) key combination. Re- 
member to hold down (ctrl) while you press (s) or (a). 
See if you can stop or start every few lines. 


Type: 
HELP (RETURN) 


again following the monitor prompt, and this time stop 
the listing with (ctrvo). Compare the effects of using 
(cTRUO) to start and stop output with the use of (ctrus) 
and (crrva), which affect the running of the program 
and the output. 


Type: 
HELP (RETURN) 


Press (ctrRuc)ctruc) to end the HELP listing. 


The effects of all special key combinations discussed 
in this chapter are shown in table 6. 


Table 6. 

Control Key Combinations 

Key Combination Function 

(CTRUS) Stops the current process 

(CTRL/Q) Starts or continues the current process 

(CTRU/O) Suppresses the display of a listing on the 
terminal 

(CTRL/CCTRUC) Aborts a program and returns control to the moni- 
tor 

(CTRUU) Deletes the line of characters to the left of the 


cursor 
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Setting the Date and Time 


Setting the date and time allows the system to keep a re- 
cord of when operations are performed, for instance, when 
files are created. If you are not sure whether the date has 
been set, you may type the DATE command followed by a 
(return). If a date has not been set, an error message will be 
displayed. 


semester etme SO RE A RE RR AS Ae MR MAR RTC MAM PA Men NA PH 


EXAMPLE 


Bain iia tin BCA, 


—2KMON- -W-No date 


Be ?KMON stands for a message aes the keyboard mon- 
oe itor. W indicates that the message is a wenUU a 
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geet, fae 
eee ee ee ee 
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If a date has not yet been set on your machine you may 
enter today’s date in this format: 


DATE dd-mmm-yy 


Hess UeSRMenep ease Tena s cgaepmt veer oer cere 
foo ENAMPLE 
| DATE 28-APR-83<reTuRN) 


Typing in the current date replaces any previous date. 

You can set the time in a similar way. Again, you 
should test to see if the time has been set by typing the TIME 
command followed by a «return. If your system does not have 
a clock, an error message will be produced. 


een mee eon regen a Derm PET A OPE OE I TP HE ORE A NE EL ETOP ENE { 


EXAMPLE 


TKMON- M- No. lock 


tal oi piso thesia 3 inicio ot tdi tlh ee acd th a oni Sis A 


If your system does have a clock, you may set it to the 
right time by following the format: 
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TIME hh:mm:ss 


Typing a new time sets the clock at that time. The sys- 
tem clock keeps track of the current time like any other 
clock; time, however, is specified in 24-hour notation. So, 
if it is 4:15 p.m., you would enter 16:15:00. 


Practice . Type: 
2-4 DAT E RETURN) 


If today’s date has not been set, type the correct date 
in the format: 


DATE dd-mmm-yy 


Type: 


T I ME(RETURN) 


If your system has a clock and the right time has not 
been set, type it in the format: 


TIME hh:mm:ss 


Type-Ahead Function 


Characters typed at the terminal while another job is run- 
ning are stored in a place called the input buffer. A buffer 
is a storage area—often a special register or a designated area 
of memory—used to hold information being transferred be- 
tween two devices or between a device and memory. If the 
job that is running does not expect or require input from 
the keyboard, the characters remain stored in the buffer for 
the next job or are interpreted as the next command by 
KMON when the current job finishes. 
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Practice 
2—5 


Summary 
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Type: 
DIRECTOR Y return) 


While the directory, listing the files stored on the system 
volume, is running type: 


DAT E(RETURN) 


Notice that the second command is run when the first is 
completed. 


KEYBOARD MONITOR COMMANDS 


DATE _ sets the date 
HELP displays information about system features 


TIME sets the time 


KEYS AND SPECIAL KEY SEQUENCES 


(cTRUCXcTRUC) aborts a program 


(CTRUO) suppresses output 

(CTRU/Q) starts a listing 

(CTRUS) stops a listing 

(CTRUU) removes the line of characters to the left of the of 
the cursor 

(DELETE) removes one character at a time to the left of the 


cursor 


File Storage Media 
Tape Structure 
Disk Block Structure 
File Specifications 
Device Names 
Physical Device Names 
Logical Device Names 
File Types 
Wildcards 
Factoring 
File Maintenance Commands 
DIRECTORY: Listing the Files on a Storage Volume 
COPY: Making Copies of Files 
RENAME: Changing the Name of a File 
DELETE: Erasing a File Name from the Directory 
PROTECT and UNPROTECT: Preventing Accidental Dele- 
tion of a File 
Summary 
References 
Solutions to Practices 
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Storing 
Data On Disks 


When you work with RT—11, you will store the data and 
the programs you create on disks or magnetic tapes. To use 
RT-11 efficiently, you need to understand how informa- 
tion is organized on these devices and how you can access 
and use it. 

This chapter discusses naming files by using file spec- 
ifications and saving time and space by using wildcards. 
Time is also spent on six simple monitor commands used 
for file maintenance: COPY, DELETE, RENAME, PRO- 
TECT, UNPROTECT, and DIRECTORY. 
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File Storage Media 


Tape Structure 


Your RT—11 system stores information in a format called a 
file on disks or magnetic tapes. A file is a collection of codes 
which represent data or computer instructions. On a disk, 
files can be accessed in any order, that is, they can be called 
up from any part of the disk. But on magnetic tape, files 
must be read in the sequence in which they have been re- 
corded. Disks provide random-access storage whereas tapes 
provide sequential-access. 


On magnetic tapes, information that identifies a file (file 
name, type, creation date, and its sequence number) is stored 
in a file header. The system automatically places a file 
header at the beginning of each file. When you have fin- 
ished putting information in a file, the length of the file is 
recorded automatically at the end of the file. The last file 
on a tape is followed by an end-of-tape mark. An empty area, 
where new files may be added, is maintained after the last 
file on the volume. When a new file is added to the tape, it 
overwrites the old end-of-tape mark. A new end-of-tape mark 
is written after the new file. This means that the most re- 
cently created file will always be the one before the end-of- 
tape mark. 


Disk Block Structure 


The basic unit for storing information on an RT—11 disk is 
a block. A block is 256 words, roughly 512 alphanumeric 
characters or one and one-half typewritten pages, in length. 
On a disk, each file starts at the beginning of a block and 
the size of a file is always given in numbers of blocks. Each 
block on an RT—11 disk is numbered starting with block 0. 
Files are stored in blocks with sequential block numbers, 
called contiguous blocks. This means that a given RT—11 
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file occupies one area on the disk instead of being broken 
up into separate areas. 

Block 0 and blocks 2 through 5 (known as boot blocks) 
contain space reserved for bootstrap programs. Bootstrap 
programs perform operations such as reading parts of the 
operating system into main memory. They are found only 
on the disk that contains the RT—11 system code. All other 
disks, such as disks that hold your data, have boot blocks 
but they are empty. 

The code in block 0 is read and executed by the hard- 
ware boot program each time you turn on your system. The 
code in block 0, in turn, reads and executes the code in 
blocks 2 through 5. Block 1, the home block, contains vol- 
ume identification information—such as the date the vol- 
ume was created and the name of its owner. 

Each disk has a file called the directory. A directory 
holds information about where files are stored on a disk and 
where empty areas are so that new files can be created. Each 
file is listed by its file name and type in the directory. Every 
file and every empty area is described by its starting block 
number and by its size in blocks. The directory always starts 
in block 6. Files are stored in the area immediately follow- 
ing the directory. 


File Specifications 


Frequently, the first step in processing data is to identify 
the file to be used. The full address of a file is called the 
file specification. The full specification for any file has three 
parts: 


1. The name and unit number of the device on which 
the physical storage medium holding the file is 
mounted. 


2. The file name, one to six alphanumeric characters as- 
signed by the person who created the file. 


3. The file type, which tells you about the format or 
contents of the information held in the file. 
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Practice 
3—1 


Device Names 
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For example, if your file specification is DX1:SUMS.MAC, 
DX1: is the name of the device on which the file is held (in 
this example an RX01 diskette). SUMS is the program name 
given by its author, and .MAC is the file type; here it tells 
you that the program is written in MACRO-11. 


Assume that you have a file called TEST written in BASIC 
and stored on the disk held on device DMO. The default file 


type for files written in BASIC is .BAS. Write the full speci- 
fication for this file. 


Sometimes you may omit the device name or file type 
from a specification, because certain utility programs as- 
sume values for these elements, called default values. Files 
are assumed to be on the default user disk if you do not 
give a device name. 


You use device names in the input and output portions of 
a command line to identify where input information can 
be found and where output information will be sent. 


Physical Device Names 


Each hardware device on an RT—11 system is identified by 
a permanent two-letter mnemonic. The mnemonics are de- 
fined in the system software and are recognized and used 
by the operating system. 

For those devices which can have more than one unit 
or drive, a third character, a number in the range 0 to 7, is 
used. This number specifies the drive number; if you omit 
it, the system assumes 0. Thus, the device name for a dis- 
kette in RX0O1 drive unit 0 is DX: or DXO: and for a diskette 
in RX01 drive unit 1, DX1:. 

So that the system can tell the difference between de- 


Practice 
3-—2 
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vice and file specifications, a colon (:) always follows a de- 
vice name. 


EXAMPLE 


-COPY DMO:MYFILE.TXT DM71 : (ReTuRN) 
-COPY DMO:MYFILE.TXT DM1 (Return) 


a nednonst tierra cen taimiintcivhnninwnan elt 


The first command copies the file MYFILE.TXT, which 
is on the RKO6/07, drive 0, onto the RK06/07, drive 1, and 
names the file MYFILE.TXT. The second command copies 
the file MYFILE.TXT to another file called DM1 which is 
also on the RK06/07, drive 0. 


Logical Device Names 


Unlike DX:, the name SY: does not represent a specific de- 
vice. It is, rather, a logical device name that can be as- 
signed to a particular physical device. SY: is used by com- 
mands which access the system volume. For example, a 
command like RUN PROGRAM-NAME (which runs pro- 
grams from the system volume) assumes that the device to 
which SY: is assigned contains the system volume. Simi- 
larly, DK: is the default logical device name for the system 
storage volume. You can assign DK: to any kind of storage 
device. Since DK: represents the default storage volume, you 
need not specify the device name in commands. 


To see what physical devices SY: and DK: represent on 
your system, type the command: 


SHOW(<RETURN) 


The listing shown will resemble this one: 


TT CResident) 
DM CResident) 
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DMO=DK, SY 
MQ (Resident) 
LD 
VM 


MM 
NL 


S free slots 


You can assign DK: to a specific disk on your system 
with the following command format: 


ASSIGN PHYSICAL-DEVICE LOGICAL-DEVICE 


Smee ey mone ammeter arate IRA pe AE MIE PHN ORME EOS EH MC LMR HEB a RE epee MC mee 


EXAMPLE : 


-ASSIGN ‘DM1: DK: (RETURN) 


be : To verify that the assignment has been made, y you one 
“s eee the’ SHOW command: re Z 


boas ie listing | like the following should a appear: CE 


STs (Residents 
pec DM CResident) 
be DMOS SY 


DMT =DK- | 
peerage (Resident a 
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File Types 
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In addition to using default logical device names, you 
may need to assign other logical device names to physical 
devices for a number of reasons. You use logical device 
names in programs you write if you cannot predict which 
physical device will be available for use. When you run the 
program, you simply assign the logical device names to the 
physical device names available on your system. A logical 
device name is made up of any three characters of your 
choice. 


EXAMPLE | | 
- ASS I GN«RETURN) | 


Physical device name? DY1 : (RETURN) | 
Logical device name? VOL : (RETURN) 


. : 
Once the assignment is made, the system recognizes | 
the logical device name VOL: as the device name for 
your volume. 


Asstt nabanciabacnainanebiines teint ist iene ana Niles ation’ op sak wine a dl Eo M Aen NUR NR ARS EMRE N iMRI SDN BS AO RASA MANME SRT ie Winn AORN oa Sa 


Logical device assignments are temporary. Thus, you 
must reassign a logical device each time you start the sys- 
tem. Table 7 lists the physical and default logical device 
names used with RT-11. 


The file type generally indicates the format or contents of 
a file. If you do not supply the file type when giving a file 
specification, the system may assume one of a number of 
types, depending on the command you have used. This as- 
sumed file type is known as the default file type for that 
command. For example, if you type RUN PROG1, the sys- 
tem assumes you are referring to a file whose specification 
is PROG1.SAV. .SAV is the default file type for the RUN 
command. Some commands, like COPY, assume a wild- 
card (an abbreviated specification) default, so the COPY 
command will be performed on all files of that name, 
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Table 7. 
Device Names 
Mnemonic Device 
Physical DUn: RD51 Disk, RX50 Diskette on 
Device Names MICRO/PDP-11, RA80 Disk 
DLn: RLO1/02 Disk 
DMn: RK06/07 Disk 
DWn: RD50/51 Disk on Professional 300 
DXn: RX01 Diskette 
DYn: RX02 Diskette 
DZn: RX50 Diskette on Professional 300 
RKn: RKO5/RK11 Disk 
MMn: TJU16 Magtape 
MSn: TS11 Magtape 
MTn: TM11 Magtape 
LP: Line Printer 
LS: Serial Line 
Ie Console Terminal 


(n represents the device unit number) 


Default Logical SY: The system volume 
Device Names DK: The default storage volume 


whatever their file type. The file types you will use most 
often are defined in table 8. (A complete list of standard 
file types is shown in table 3—2 of the RT—11 System User’s 
Guide.) 


If you are doing the same operation on a number of files 
with similar file specifications, it may be more efficient to 
use special symbols called wildcards in the file specifica- 
tion instead of naming each file. When you use a wildcard, 
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Table 8. 

Frequently Used File Types 

File Type File Represented 

.BAS BASIC source file 

.FOR FORTRAN source file 

.MAC MACRO source file 

.DBL DIBOL source file 

.BAK The backup file created by a text editor 

.OBJ The object file—a binary file made up of an assem- 
bled or a compiled program 

SAV The file type given to executable code—the version ' 
of a program that is run by the computer 

.LST The listing file produced as output at the line printer 

.COM The command file type 

SYS The monitor file and handler file type—the file type 


given to system programs 


the operation specified by the command is performed on 
all files which match the pattern you have provided. 

Two symbols are used as wildcards in RT—11. An as- 
terisk (*) can replace any character or a string of charac- 
ters. A percent sign (%) can replace any single character. If 
you have a series of files with the same file type suffix, like 
SUMS.BAS, WORK.BAS, and GAMES.BAS, for instance, you 
could use the notation *.BAS to mean all of these files. 

The percent sign (%) is used when file specifications 
differ in one character only. For example, if you want to 
perform an operation on files called TEST1.BAS and 
TEST2.BAS, you can use the wildcard notation TEST%.BAS 
to represent these files. If there is also a file called 
TEST3.BAS, the wildcard will access it, too. 

You can use wildcards in place of file names, file types, 
or characters in file names or file types. You can also use 
wildcards to represent part of a file name. For example, 
US*.* specifies all files whose names begin with ‘US” on 
the current volume. The wildcard *.*, on the other hand, 
will access all files on the current storage volume. You 
cannot, however, use wildcards to specify devices. 
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Practice 
3-3 
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Factoring is another method of specifying a number of files 
without typing in the name of each file individually. For 
example, TEST(A,B,C).MAC is equivalent to TESTA.MAC, 
TESTB.MAC, TESTC.MAC. 


You have the following files: 


ak, 
. 


TESTM.MAC 
TESTF.FOR 
TESTB.BAS 
TESTD.DBL 
TENTM.MAC 
TENTF.FOR 
TENTB.DBL 
TINTM.MAC 


2. 
3. 
4. 
5. 
6. 
7. 
8. 
9. 


TEAKM.MAC 


Which of the following file specifications selects 1, 2, 3, 5, 
6, 7, but not 4, 8, or 9? 


a. TE%T (M,F,B).* 
b. T*.(MAC,FOR,DBL) 
c. *(M,F,B).* 
TE%T*.* 
TE*.(MAC,FOR,DBL) 
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File Maintenance Commands 


When you receive your RT—11 system, the system volume 
contains only the files of the RT—11 operating system—the 
monitor files, the system device handlers, the system util- 
ity programs, and perhaps the language processors. How- 
ever, since the system volume serves as the default storage 
volume for all system operations (unless the name DK: was 
assigned to another volume), you will discover that it ac- 
quires many additional files during normal use. For exam- 
ple, when you create files with the keypad editor, they are 
stored on the system volume; when you edit files, the key- 
pad editor automatically saves the original on the system 
volume; and many utility programs create output and list- 
ing files as part of their normal operation. By the time you 
finish an average session of computer operations, several 
new file names may have been added to the directory of 
your system volume. 

To avoid having your system volume become full and 
its directory cluttered with the names of files for which you 
have no use, you should perform regular file maintenance 
operations as you use the system. That is, you should up- 
date and transfer copies of your important files to other 
storage volumes for safekeeping and you should delete from 
your system and storage volume directories the names of 
files you no longer need. 

The RT-11 operating system provides a number of 
monitor commands for this purpose. These commands ac- 
tivate the RT—11 utility programs called PIPSSAV, DUP.SAV, 
and DIR.SAV, which allow you to transfer and erase files. 
Using the monitor commands introduced in this chapter is 
one way to maintain your system and storage volume. 


DIRECTORY: Listing the Files 
on a Storage Volume 


Both your system volume and your storage volume have 
directories, which are compiled lists of all the files stored 
on the volume. The DIRECTORY command elicits lists of 
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information about a device, a file, or a group of files. The 
DIRECTORY command does not prompt you for informa- 
tion. If you do not specify a device name or a file name and 
a file type, the system lists information about all the files 
on the default storage device. 

Monitor commands may be abbreviated to the mini- 
mum number of characters necessary to define a command 
uniquely. For instance, instead of typing the command 
DIRECTORY—as you did in practice 2—5—you may trun- 
cate the command to DIR. Table 9 lists the minimum ab- 
breviation for each monitor command. In general, abbrevi- 
ating to three letters gives a unique command. 


Table 9. 
Monitor Command Abbreviations 


Monitor Monitor 

Command Abbreviation Command Abbreviation 
ABORT AB INSTALL INS 
ASSIGN AS LIBRARY LIB 
BACKUP BAC LINK LIN 
BASIC BAS LOAD LO 
BOOT BO MACRO MAC 
CLOSE CL MOUNT MO 
COMPILE COM PRINT PRI 
COPY COP PROTECT PRO 
CREATE CR REENTER REE 
DATA DA REMOVE REM 
DEASSIGN DEA RENAME REN 
DELETE DEL RESET RESE 
DIBOL DIB RESUME RESU 
DIFFERENCES DIF RUN RU 
DIRECTORY DIR SAVE SA 
DISMOUNT DIS SET SE 
DUMP DU SHOW SH 
EDIT ED SQUEEZE SQ 
EXECUTE EX SRUN SR 
FORMAT FORM START ST 
FORTRAN FORT SUSPEND SUS 
FRUN FR TIME Tl 
GET GE TYPE TY 
HELP H UNLOAD UNL 
INITIALIZE INI UNPROTECT UNP 


Practice 
3—4 
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Get a directory listing of all the files on your storage device 
with file names ending in the letters ST or TS by typing the 
command: 


DIR *CST,TS). * (RETURN) 


You can use the DIRECTORY command to obtain a list 
of files on magnetic tape too, even though tapes have no 
directory as such. When producing a directory listing from 
magnetic tape, the utility program reads through the whole 
tape displaying each file header it encounters. 


COPY: Making Copies of Files 


The COPY command transfers the contents of one file to 
another file, the contents of a number of files to a single 
file, the contents of files from a large volume to several 
smaller volumes, the bootstrap code to a volume, or the 
contents of one device to another device. It instructs the 
system to duplicate the file that you indicate as input, then 
gives the new file the name and type that you specify as 
output. The original version of the file is unaffected. 

You saw the long and short formats of this command 
in chapter 2, but they are repeated here to refresh your 
memory. 


“EXAMPLE 


Long format: 


. COP (RETURN) 
From? INPUT .-T X T(RETURN) 
pal is Kaen ce OUTPUT. PE TGETURN 


Short format: 


i COPY INPUT. TXT QUTPUT. TxTaea as 


sin intaitans Sumani SR nha nisi ni aa ban ati sas i ibn iba 
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One of the files provided with your RT—11 operating system 
is called DEMOED.TXT. Use the long format of the COPY 
command to copy the contents of the DEMOED.TXT file 
into a file called PRACT.TXT. The following exchange be- 


tween you and the system should take place: 


- COP Y(RETURN) 
From? DEMOED. TX T«ReETuRN) 
To ? PRACT. TX T«RETURN) 


RENAME: Changing the Name of a File 


Practice 
3—6 


You can use the RENAME command if you want to change 
the file name or the file type. It changes the name or type 
of a file in the directory without changing or moving the 
contents of the file. Thus, when you give a RENAME com- 
mand the storage device indicated in the input and output 
portion of the command should be the same. 


ppc =e emmy en ernest epee cn teehee eect ta ena mee 


me RENAME @etuaNy 
SErom?ocENP.UTs TXT @eTuRN) 
To ? ‘QUTPUT. TXCTIRETuRN) 


; ae format: 


steals INPUT. TXT ‘OUTPUT. TATUM 


[sen eee a re ernie manneonet secon ram are arene eaten enosenamee neonate ese 


a NaN IE: iD ich ee mo RE niet ic soho bd 


Use the short format of the RENAME command to re- 
name the file PRACT.TXT to BILL.TXT. Type: 


RENAME PRACT.TXT BILL. TX T«Return) 
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2. Call up the directory to see that PRACT.TXT is no 
longer in the directory by typing the command: 


DIR PRACT. TX T RETURN) 


DELETE: Erasing a File Name 
from the Directory 


Practice 
3—7 


Once copies of your important files are stored on a storage 
volume, you may want to delete from the system volume— 
or any storage volume—the files you no longer need. When 
you issue the DELETE command, you tell the system to re- 
move information about the file you specify from the vol- 
ume’s directory. In doing so, the space that the file occu- 
pies on the volume becomes available for reuse. 

You can use wildcards when issuing the DELETE 
command, but you must do this with caution as file speci- 
fications containing wildcards may match a large number 
of files. The system will ask for confirmation before it de- 
letes files when there are wildcards in the file specifica- 
tion. 


Delete BILL.TXT using the long format of the command. 
Type: 


DELE T E(RETURN) 


Wait for the monitor prompt: 


Files? 


Type: 
BILL. TX T(RETURN) 
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PROTECT and UNPROTECT: Preventing 
Accidental Deletion of a File 


Practice 
3-8 


If you have files that are valuable or important, you may 
want to use the PROTECT command to prevent accidental 
deletion. The short command format is PROTECT FILE.TXT. 
When you protect a file, you will not be able to delete it 
without giving the UNPROTECT command. 

You can specify as many as six input files (separated 
with commas) in the PROTECT or UNPROTECT command 
line. As with the DELETE command, you can also use the 
wildcard construction. Once you have protected a file, its 
protected status will show up in the directory listing with 
a ‘“P” next to the block size number of the file’s directory 
entry. 


ce aise poi ngipceoe otha ct aaa ioe in eeeenata cian 
| EXAMPLE es oe Beet Po 
: LPROTECT@ewan) ete nse 
Se ‘Files? DEMOF1. FOR(eTUR) ees, Cees - 4 
ae .DIR DEMOF1. -FOR(ETURN) OO a ee ae 
19- Apr - -83 pe 
| DEMOR| GEOR 2P.12-Dec-82) 
Ss File, 2: Blocks (2) - Sa ree re 
E Bes: Free blocks pes se ae 


It you try to delete a protected file you 2 will see. an er- oo 
Tor. ans aRes = 


peor eee 


Peles W- Protected File FILE. at ee 


ES api RRA Sob BSN ec AE RG MRT MISE SR TSR EG NER A Ri REND FB LA LEI GE AVS ROGER ts I OD: Sele pens in Si Aa NE BARS Ne AR US oN RARER REN ol ceoe aR 


Unprotect the file SY:DEMOED.TXT. 


Use the PROTECT command to return the file to its 
original status. 


Use the DIR command to see how its protected status 
is shown. 
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Summary 
A FILE SPECIFICATION INCLUDES 
Device name 
File name 
File type 
FILE MAINTENANCE COMMANDS 
COPY transfers the contents of one file to another file 
DELETE erases a file name from the directory 
DIRECTORY lists the files on a storage volume 
PROTECT prevents accidental deletion of a file 
RENAME changes the name of a file 
UNPROTECT _ removes the protection status of a file 
References 


Introduction to RT—11. Chapters 4 and 7 discuss entering 
and using file maintenance commands. 


RT-11 System User’s Guide. Chapter 4 discusses and lists 
keyboard commands alphabetically. Appendix A gives command 
abbreviations. 


RT-—11 Software Support Manual. Chapters 8 and 9 discuss 
file format and storage. 


Solutions to Practices 


3-1 

3-3. (a) TE%T (M,F,B).* 

3-8. (1) UNPROTECT SY:DEMOED.TXT 
(2) PROTECT SY:DEMOED.TXT 
(3) DIR SY:DEMOED.TXT 


Editing on a Display Terminal 
Starting the Keypad Editor 
Creating Files 
Saving Files and Leaving the Keypad Editor 
Editing Files 
Inspecting Files 
Using Function Keys 
Getting Help in the Keypad Editor Mode 
Using the GOLD Key 
Using the Cursor Keys 
Moving the Cursor by Units of Text 
Searching for Characters and Words 
Inserting, Deleting, and Restoring Text 
Inserting Special Characters 
Inserting Blank Lines 
Deleting Characters 
Deleting Words 
Deleting Lines 
Restoring Text 
Editing Sections of Text 
Deleting, Copying, and Moving Sections of Text 
Changing Case, Replacing, and Substituting 
Sections of Text 
Summary 
References 
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Using 
KED to Edit 
Text Files 


A text editor is a utility program used to create and modify 
files of printable characters. Text files contain the letters, 
numbers, and symbols you type in at your keyboard; they 
may be programs, data to be used in programs, reports, 
memos, or sequences of monitor commands. 

The text editors available on RT—11 include a keypad 
editor KED, and a line editor, EDIT. If you have a video 
display terminal, you will use a keypad editor instead of 
the line editor to create and edit text files. 

In this chapter you will learn to use KED to perform 
the following operations: create, edit, and inspect files; move 
the cursor to any position within your file; search for a word 
or character; insert, delete, and restore text in files. You will 
also learn to set a select range and use the CUT and PASTE 
commands to change the position of text within your file 
and leave the keypad editor with or without saving the 
changes you made when editing. 

(If you do not have a video display terminal, refer to 
chapter 6 in the RT—11 System User’s Guide for a discus- 
sion of EDIT, the text editor for printing terminals.) 
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Editing on a Display Terminal 


The keypad editor, also known as a screen editor, allows 
you to move freely within a text file and see immediately 
the corrections you are making. 

The keypad editor allows you to edit using keys with 
special functions. On a VT100 terminal, these keys are found 
on or near the numeric keypad. If you are using a Profes- 
sional 300 computer, you will find the function keys on the 
numeric and editor keypads. Figure 7 shows the functions 
of the keys on the numeric keypad; the functions are the 
same on the VT100 and Professional 300 terminals. The al- 
phanumeric characters or symbol at the center of a key is 
the label that actually appears on each key. The term above 


Figure 7. 
Keypad Functions on the VT100 and 
Professional 300 Terminal 


FINDNEXT DELLINE 


PF3 PF4 


SECTION APPEND DELWORD 


ADVANCE BACKUP DELCHAR 


SELECT 


Practice 
41 
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the label or the label itself describes the function the sys- 
tem performs when you press the key. The term below the 
label represents the function the system performs when you 
press (Goo) (labeled PF1) first. You can use the main key- 
board to type in characters as usual, but in this chapter you 
will concentrate on the function keys and some control 
characters that have special functions within the keypad 
editor. 

You create and edit text files more often than you per- 
form any other system operation. To facilitate these pro- 
cesses, two RT—11 editor system utility programs, EDIT.SAV 
and KED.SAV, are stored as part of the RT—11 operating 
system on your system volume. On all RT—11 systems, EDIT 
is the default text editor when you start the system. This 
means that when you issue the monitor command EDIT, the 
EDIT.SAV text editor program is run. 


If you have a video terminal, set KED as your default editor 
by typing the command: 


SET EDIT KEDvreturn) 


Starting the Keypad Editor 


Creating Files 


The monitor command that starts the keypad editor is 
EDIT/KED. Since KED is already your default editor, you 
can simply enter the command, EDIT. The system prompts 
you for a file name after you issue the command. 


The RT—11 editor uses an area in main memory reserved 
for text that you are typing in for the first time or editing. 
This area is called the text buffer. When you create a file, 


Working with RT—11 


the characters you type in at the keyboard are transmitted 
to the text buffer. When you have finished typing text into 
the file, the file is transferred from the text buffer to an out- 
put file for storage. The monitor command to use the key- 
pad editor to create a file is: 


EDIT/CREATE FILENAME 


eR PEE ema TE AEP NPE Ea re WF te me ER PE RT NRT 


oe EXAMPLE : = SS ee 


-EDIT/CREATE. TEST. LTH acu 


sini goin BSA iain se Wh data abode is ic lian ach de 


ogee oh Race te ae | 
pe eeere herr ee ene | 


zs 
: 
eS 


The name you select for your file should not be the 
same as a file which you have created previously in your 
directory. If you try to repeat a name, an error message will 
be produced. 


sate eye a or ere UNE Mt ePaper cemreereneceemorer mney 


“EXAMPLE. 


KED- W- ‘Output file exists ~Continue Y, ND? 


- sponse. If you type in Y; meaning to continue, the | e a 
enging|; file will be erased. ee a a 


eterna remtnene mete ene seem nce 


| 

| 

ee | 
The warning message asks you es a yes or no. re- - ae 4 

{ 

| 

| 


ve ha io debs 2 ER ia yt ane gy tls ve Onan ea i 8 eS Sea Nc RDN bi BROAD i A SI hGH SA De ia cha 


Saving Files and Leaving the Keypad Editor 


When you have created or edited a file and want to save it 
as you leave the keypad editor, press the cow) key followed 
by (commann). Pressing these function keys tells the keypad 
editor that you want to enter a command. The editor, in turn 
will display the prompt: 


Command: 


You should then type the word EXIT and press enter) 
on your keypad. The system will transfer the information 
in the text buffer into an output file and bring you out of 
the keypad editor mode and into the RT—11 monitor com- 
mand mode. 
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EXAMPLE 


(GOLD)(COMMAND) 
Command: EX 1 T«eNnTER) 


* . 

d i 
‘ y 
$ ? 
r i 
Iecisnet sicharesnceienid rennet se att 


To leave the keypad editor and save the file but not 
the edits made to it, you type QUIT instead of typing EXIT 
when the editor prompts you for a command. 


Practice . Select a file name, for example TEXT.TXT, and create 
4—2 a file using the keypad editor. Type: 


EDIT/CREATE TEXT. TX T(RETURN) 


If you have typed in the command correctly, you will 
see the cursor positioned on a special symbol, a filled 
block, known as the end-of-file marker. 


Type in approximately five lines of text (input a short 


passage from this book for example). Do not worry 
about mistakes at this time. 


When you have finished typing in the text, press (GOLD) 
and then (commano). After the system prompt, type: 


EXIT 


and press Enter). Your file TEXT.TXT is now stored 
and you should see the dot monitor prompt. 


Editing Files 


To edit a file that you created previously, use the monitor 
command: 


EDIT FILENAME 


When you issue the EDIT command, the system copies 
the file you specify (known as the input file) and transfers 
the copy to the text buffer where you can modify the ma- 
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terial. When you are satisfied with the edits made to the 
text in the buffer, you may issue either the EXIT or QUIT 
command. 

If you use the EXIT command, the edited text in the 
buffer is copied into the file you specified (now known as 
the output file); the edited text replaces the original text in 
the file. | 

If you typed in QUIT rather than EXIT when the sys- 
tem prompts for a command, the system returns to the 
monitor command mode without transferring the text in the 
buffer to the output file on a storage medium. The edited 
text in the buffer is lost and the original text remains stored 
in the file. 

If you want to store the edited text in a file with a dif- 
ferent name, you can use the /OUTPUT option to the EDIT 
command. By specifying a different name for the output file, 
KED will store the edited text in a new file and leave the 
original text in the input file unchanged. The format for this 
command is: 


EDIT/OUTPUT:OUT-FILENAME IN-FILENAME 


When you edit a file, RT—11 automatically saves the 
original version as a backup file. It copies the original text 
into a file using the same name and assigns the .BAK file 
type to the backup file. For example, if you edited a file 
called TEST1.MAC the backup copy of the file would be 
called TEST1.BAK. 


The keypad editor also allows you to examine files without 
making any changes in them. To do this you use the EDIT 
command with the /INSPECT option. The format is: 


EDIT/INSPECT FILENAME 
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Using Function Keys 


Getting Help in the Keypad Editor Mode 


When you are using the keypad editor, you can get help by 
pressing (etry. This key is labeled PF2 on the VT100 and 
Professional keyboards (see figure 7). The key labeled HELP 
on the top row of the Professional keyboard does not work. 
When we refer to (Hevr) in the remainder of this book, we are 
referring to the PF2 key. 

When you press (Help) you will see a diagram of the 
keypad, which shows you the position of the functions 
available. You can also get messages explaining errors by 
pressing (HELP). When you use a keypad function incorrectly, 
a bell rings. If you press (evr) after the bell has sounded, in- 
stead of the keypad display, you will be given an explana- 
tion of your error. 

By pressing (HELP) twice, you can get a listing and de- 
scription of all the commands and functions available to the 
keypad editor (see table 10). To enter one of these com- 
mands, you must press (coup) (command) and type in the com- 
mand after the prompt. When you have finished entering 
the command, press <eNTER). 


Using the GOLD Key 


When used by itself, (cou) (labeled PF1) has no effect. In- 
stead, it enables the alternate function of other keypad keys 
to work. Except for (Hur) and (Goi), you will see that all the 
other keys on the keypad have two functions. The two 
functions available as well as the label on each key of the 
VT100 and Professional 300 numeric keypad are shown in 
figure 7. To use the lower function on a key you must press 
(so.o) followed by the function key. 

By using the number keys on the keyboard (not those 
on the keypad) and on), you can repeat a function any 
number of times. Press (coin) and the number of times you 
want to repeat a function before you specify the function. 
For example, cou)7«e.cHar) deletes seven characters to the right 
of the cursor. 
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Table 10. 

Summary of Commands and Keyboard Functions 

CLEAR PASTE Clears the paste buffer 

CLOSE Closes the auxiliary output file 

EXIT Closes all open files 

FILL Reformats the select range to fit within 
the current right margin 

INCLUDE nnn PAGES Copies pages from the auxiliary input 
file 

INCLUDE nnn LINES Copies text lines 

INCLUDE REST Copies the remainder of the file 

LEARN Begins recording a sequence of com- 
mands and functions as an editor 
macro 

LOCAL [starting-value [increment]] _ Renumbers MACRO-11 local 
symbols 

[OPEN] INPUT FILESPEC Opens an auxiliary input file 

[OPEN] OUTPUT FILESPEC Opens an auxiliary output file 

PURGE Purges the auxiliary output file 

QUIT Purges all open files 


SET [ENTITY] PAGE nnn [LINES] Defines a page by line count 

SET [ENTITY] PAGE “string” or ‘string’ 
Defines a page by marker string of one 
or more characters 

SET [ENTITY] SECTION nnn [LINES] 
Defines a section by line count 

SET [ENTITY] SECTION “string” or ‘string’ 
Defines a section by a marker string 
of one or more characters 


SET QUIET Sets the video terminal to signal with 
the reversed background 

SET NOQUIET Sets the video terminal to signal with 
the terminal bell 

SET [SCREEN] 80 Sets the video terminal to 80-column 
width 

SET [SCREEN] 132 . Sets the video terminal to 132- 
column width 

SET [SCREEN] LIGHT Sets the video terminal to light back- 
ground 

SET [SCREEN] DARK Sets the video terminal to dark back- 
ground 

SET [SEARCH] GENERAL Matches alphabetically regardless of 


case 


Chapter 4 Using KED to Edit Text Files 61 


Table 10. Continued 


SET [SEARCH] EXACT 
SET [SEARCH] BEGIN 
SET [SEARCH] END 


SET [SEARCH] BOUNDED 
SET [SEARCH] UNBOUNDED 


SET TABS [indent] 
SET NOTABS 
SET WRAP [nn] 


SET NOWRAP 
SKIP nnn PAGES 


SKIP nnn [LINES] 

SKIP REST 

TABS ADJUST ({+})nnn 
WRITE nnn PAGES 


WRITE nnn [LINES] 
WRITE REST 
WRITE SELECT 
{CTRL/C) 


(CTRL/U) 
{CTRL/W) 
(CTRUZ) 
(DELETE) 
(LINEFEED) 
(GOLD)nnn 
{GOLD)<S) 
{GOLD)<X) 


{GOLD)E) 
(GOLD)<D) 
{GOLD)<A) 


Matches alphabetically and requires 
the same case 


Leaves the cursor at the beginning of 
the target 


Leaves the cursor at the end of the 
target 


Limits searching to a page 

Allows searching beyond the current 
page 

Enables structured tabs 

Enables structured tabs 


Sets the right margin and enables 
word wrap 


Disables word wrap 

Skips pages within the auxiliary input 
file 

Skips text lines 

Skips the remainder of the file 
Changes indentation 


Writes pages (as currently defined) to 
the auxiliary output file 


Writes text lines 
Writes the remainder of the file 
Writes the select range 


Cancels the command or function that 
is being processed 


Erases one line to the left 

Repaints the screen 

Cancels editor prompts 

Erases one character to the left 
Erases one word to the left 

Repeats the next function nnn times 
Stops recording the macro 


Executes the macro, as currently re- 
corded 


Increases the tab level-counter 
Decreases the tab level-counter 


Aligns the tab level-counter to the 
cursor 


Using the Cursor 


Practice 
4-3 
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Keys 


The cursor keys on all VT100 and Professional 300 key- 
boards are clearly marked with arrow symbols. The right 
©) and left ~~ arrow keys move the cursor, character by 
character, forward and backward through the file. The right 
arrow key ~) moves the cursor to the right and from the end 
of one line to the beginning of the next line. The left arrow 
key (~ moves the cursor to the left and from the beginning 
of a line to the end of the preceding line. Instead of moving 
the cursor character by character, you can use (cou) along 
with either the left or right arrow key to move the cursor 
directly to the beginning or to the end of a line. 

The up (t) and down (|) arrows move the cursor, line 
by line, vertically through a file. The up and down arrows 
move the cursor directly up and down, keeping it in the 
same vertical column of text. When the text line does not 
reach the column the cursor happens to be in (at the end 
of a paragraph, for instance) the cursor moves back to the 
column where the text line ended. 


Find the arrow functions on your keyboard. Use the 
EDIT/INSPECT command to gain access to the file you just 
created and use the arrow functions to move the cursor up 


and down and then left and right within your file. When 
you are familiar with how the functions work, use the EXIT 
command to leave the file. 


Moving the Cursor by Units of Text 


The cursor can also be moved by using other keypad func- 
tions. You set the direction in which you want the cursor 
to move by pressing (ADVANCE) OF (BACKUP). (ADVANCE) Moves the cursor 
forward through the file. (sackup) moves the cursor backward 
through the file. 

After you have set the directional mode by pressing 
(ADVANCE) OF (BACKUP), yOU Can instruct the editor to perform a 
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number of functions in the direction indicated. (The arrow 
functions are not affected by the directional mode. They al- 
ways move the cursor in the directions indicated on the 
keys.) 

The size of the unit the cursor moves is set with the 
following functions: (char) moves the cursor, character by 
character; (word) moves the cursor, word by word; (01) moves 
the cursor to the end of a line; and (euney moves the cursor 
to the beginning of a line. 

Depending on the directional mode, (char) advances or 
backs up the cursor one character, and (word) advances or 
backs up the cursor to the first character of a word. Some 
keyboards may not have the CHAR function. 

Both (01) and (suney move the cursor in units of a line. 
(cot) moves it to the end of the next line, in the direction set 
by (ADVANCE) Or (BACKUP). (BLINE) Moves the cursor to the beginning 
of the next line, again in the direction you have set. 

To move the cursor directly to the beginning or end of 
a file, you can use oid) with cop) or (Bottom). 


Practice . Use the EDIT command to gain access to one of your 
4—4 files. Press (apvaNce) to set the direction of the cursor. 
Try moving the cursor through your text with (char) and 
with (worp). Then try positioning the cursor at the be- 
ginning and end of lines using (Eot) and (BLINE). 


Change the direction of movement using (BAckup). Try 
moving the cursor by character, word, and line. 


Press (Go.otop). When the cursor has reached the begin- 
ning of the file and stopped, press (GoLo)BoTTom). You 
may want to practice using the keypad functions men- 
tioned until you become familiar with them. 


Searching for Characters and Words 


The FIND function allows you to search your file for a spe- 
cific character or word. The search will start at the point 
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Practice 
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where the cursor is positioned. If you want to search the 
complete file, then position the cursor at the beginning of 
the file by pressing Gotpytop). 

When you press (GotpyFino), you will receive the follow- 
ing prompt at the top of the screen: 


Model: 


You then type in the character or word you want to find 
and complete the command with (apvance) or (Backup) to spec- 
ify the direction of the search. The character or word you 
supply in response to this prompt is known as the search 
target. 

If you want to search for the same word again, press 
(FiNDNEXxT). The search will take place in the direction set by 
(ADVANCE) OF (BACKUP) When you used ino). If you try to continue 
the search beyond the beginning or end of the file, you will 
hear a bell. Pressing (Her) will give you the error message: 


Search finds end of file 


Use the EDIT command to get access to a file and press (Goi) 
(Find). Search your file for a word, such as the, or a character 
that appears frequently. Use (FinDNEXxT) to continue the search. 


Try searching both backward and forward through the file. 
When you are familiar with the FIND function, exit from 
the file. 


Inserting, Deleting, and Restoring 


Text 


Inserting Special Characters 


When you insert material into a file that you are creating 
or editing, you simply type the text on the keyboard just as 
you would on a typewriter. You cannot however, insert some 
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characters by simply typing them on the keyboard. To in- 
sert special characters, such as ESCAPE or LINEFEED, you 
can use the SPECINS function key. The SPECINS function 
inserts the character when you specify the character’s AS- 
CII code in decimal. When you use the sequence, (couoyinte- 
gergotoysrecins), the keypad editor interprets the integer you 
type as a decimal value, evaluates the seven low order bits, 
and inserts the corresponding ASCII character. Except for 
the NULL character, you can use the SPECINS function to 
insert any character in ASCII. 


EXAMPLE 
(GOLD) 2 7 (GOLD)(SPECINS) 


inserts the ESCAPE character (ASCII octal 033, deci- 
mal 27). i 


Inserting Blank Lines 


Practice 
4—6 


If you want to insert a blank line in your file, you can either 
press (RETURN) OF press (GoLD) With (openuine) on the keypad. coup) 
(OPENLINE) inserts a blank line to the right of the cursor. Char- 
acters that were originally to the right of the cursor move 
down one screen line, and the keypad editor scrolls all lines 
below the cursor downward. 


Use the EDIT command to gain access to a file. Insert 
blank lines in the text first by pressing (reTuRN) and then 
by pressing (GOLD)(OPENLINE). 


Now use the OPENLINE function to insert more than 
one line. Press (60.0), type the number of lines you 
want inserted (2 for instance), and then press (GOLD)(OPEN- 
ine). When you are familiar with the function use the 
EXIT command to store your file. 
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Deletions in your file can be done in three ways, by 
one character at a time, by one word at a time, or by an 
entire line at a time. 


Deleting Characters 


Deleting Words 


Deleting Lines 


Practice 


4-7 


(oeLcHAR) ON the keypad erases the character at the current 
cursor position. (oetetey on the keyboard erases the character 
preceding the cursor. 


- The keypad editor considers any text enclosed in spaces, 


tabs, or new lines as a word. There are two methods of de- 
leting a word: oetword) on the keypad erases forward from 
the cursor to the first character of the next word. When you 
use (pELworD) to erase a word you also erase any spaces before 
the next word. «nereeo) on the keyboard erases backward from 
the cursor through the first character of the current or pre- 
ceding word. 


(oeLLNE) on the keypad erases forward from the cursor to the 
beginning of the next line. When the operation is com- 
plete, the cursor is at the beginning of the next line. 

(pELEOL) erases forward from the cursor to the end of the 
current line; the cursor remains at the end of the current 
line. 7 
cctau) (holding down ctrl) on the keyboard while press- 
ing (u)) erases back to the beginning of the previous line. 


1. Use EDIT to get access to a text file. Type in a few sen- 
tences and erase characters from them using (DELCHAR) 
and then (OELETE). 


Restoring Text 


Practice 
4—8 
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Practice using (DELWORD) and (LINEFEED) to erase words. 
Look at the position of the cursor after each deletion. 


Try the three ways of deleting a line of text. Look at 
the cursor position on completion of each operation. 
When you have finished using the delete functions, 
use EXIT to return to the monitor command mode. 


The keypad editor uses a character buffer, a word buffer, 
and a text line buffer to store the last character, word, or 
line that you erase. If you find you have erased a character, 
word, or line by mistake you can use either the UNDEL- 
CHAR, UNDELWORD, or UNDELLINE functions to copy the 
contents of the buffer back into your file. (Gouo)unpeLcHar) on 
the keypad restores a character to the file. (Go.p)unpetworp) on 
the keypad restores a word to the file. And (Goto)unpetuiney on 
the keypad restores a line of text to the file. 


Use EDIT to get access into a file. Try deleting and restoring 
text in your file in units of characters, words, and lines. (Re- 


member that you can only restore text that you just deleted; 
the latest deletions replace previous deletions in the buffer.) 


Editing Sections of Text 


When you are editing a file, you may find that you want to 
move or modify sections of the text. For example, you have 
the sentence, ‘““That is the question To be or not to be,”’ and 
want to move the whole phrase “To be or not to be’’ and 


place it before the phrase ‘“‘That is the question.” 
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The keypad editor provides you with functions to do 
this, as well as functions to copy sections of text or remove 
them. You need to indicate to the editor the section of text 
you want to copy, move, or replace. To do this you must 
establish a select range. To set a select range, you press 
(seect). The range begins at the position of the cursor. Mov- 
ing the cursor to the right or left causes text to be included 
in the select range. A left select range includes the charac- 
ters to the right of the cursor. A right select range stops with 
the character to the left of the cursor. 

After selecting a range of text, you can do a variety of 
operations on the material. You can move, copy, or delete 
text using (cut), (paste), and (aprend). Or you can change text us- 
iMg (CHNGCASE), (REPLACE), ANd (SUBSTITUTE). 


Deleting, Copying, and Moving 
Sections of Text 


The CUT function removes the selected range of text 
from the screen and stores it in the paste buffer. This spe- 
cial buffer holds text during editing. The PASTE function 
inserts the contents of the paste buffer to the right of the 
cursor. You will see the text in the select range reappear on 
the screen. 


Practice . Use the EDIT command to get access to the text file 
4-9 you have been using for the practices, or use 
EDIT/CREATE to start a new file. Type the following 
text into your file: 


That is the question To be or not to be. 


Set the select range for the phrase To be or not to be 
by moving the cursor to the T in To and pressing the 
(SELECT) key. Advance the cursor until it is at the end of 
the phrase (one space to the right of the period). Use 
(cut) to store the phrase you have selected, in the paste 
buffer. Move the cursor to the beginning of the sen- 
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tence (one space to the left of the T in That). Press 
(GOLD)PASTE) to insert To be or not to be at the start of the 
sentence. 


When you are familiar with the CUT and PASTE func- 
tions use EXIT to store the file. 


The only difference between the CUT and APPEND 
functions is that the CUT function discards any selection 
previously in the paste buffer and replaces it with the cur- 
rent selection. The APPEND function preserves the selec- 
tion in the paste buffer and adds the current selection at 
the end of it. 


Changing Case, Replacing, and Substituting 
Sections of Text 


The CHNGCASE function changes uppercase letters to 
lowercase letters and lowercase letters to uppercase letters 
in the following cases: 


1. With the cursor on a letter, the CHNGCASE function 
changes the case of only the cursor’s character and 
then, depending on the directional mode, advances 
or backs up the cursor by one character. However, 
the CHNGCASE function may have a different effect 
if you are using the SELECT, FIND, or FINDNEXT 
functions. 


2. If the cursor is on a character within a select range 
when you press (Go.o)cunecase), the function changes the 
case of each letter in the select range and cancels the 
select range. 


3. When the cursor is on a character that is at a valid 
search target (and you are not building a select 
range), the CHNGCASE function changes the case of 
each character in the search target. The function does 
not move the cursor. 
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The REPLACE function erases and discards a select 
range or search target, inserts the contents of the paste buffer, 
and places the cursor at the character that follows the in- 
sertion. When the paste buffer is empty, the keypad editor 
erases and discards the selection or search argument and 
inserts nothing. (coupyrepLace) is a Convenient way to erase a 
string that may otherwise require using a combination of 
delete functions. 

The keypad editor always replaces a select range when 
one exists. The keypad editor replaces a search target only 
if no select range exists and the cursor is at a valid search 
target. When you use the REPLACE function to replace a 
search target, the keypad editor stores the search target in 
the word buffer. 

The SUBSTITUTE function accomplishes both a RE- 
PLACE and a FINDNEXT process when the cursor is at a 
valid search target. (Remember that you can use ¢inonext) only 
after you have used ¢ino).) You can change several occur- 
rences of a string to whatever is in the paste buffer by re- 
peating the SUBSTITUTE function. The sequence is: 


(GoLD) integer(GoLD)suBsTITUTE) 


The keypad editor accepts integers in the range from 1 to 
32767. 


Use EDIT to get access to a practice file. Type the fol- 
lowing text into your file: 


Although it is Digital’s smallest operating system for 
the pdp—11 processor family, RT—11’s features com- 
pare very favorably to those of much larger systems. 


Use CHNGCASE to make pdp—11 uppercase. 
Use REPLACE to erase the string: 


Although it is Digital’s smallest operating system for 
the PDP—11 processor family,. 
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Type the following text into your text file: 


Thank RT-11 parts. How do you choose a material for 
the structural members of an airplane wing? Or any 
other members of an aircraft that will travel at great 
speed? Whatever members are chosen must success- 
fully endure the tremendous stresses of modern flight. 


Use (cut) to delete the word parts from the first line. 
Then use (FIND) and (susstituTe) to change each occurrence 
of members to parts. 

When you have finished editing your file, use the EXIT 
command to leave the keypad editor. 


Summary 
COMMANDS USED WITH KED 


EDIT/CREATE creates a text file 


EDIT/INSPECT allows you to examine a file without making 
changes to it 


EDIT/KED allows you to modify the contents of a file 
you created previously 


EXIT‘enteEr) saves the file you created or edited and takes 
you from the keypad editor mode to the 
monitor command mode 


QUIT«enter) takes you from the keypad editor mode to 
the monitor command mode without saving 
the edits made to a file 


SET EDIT KED makes KED the default keypad editor 


FUNCTION KEYS USED WITH KED 


(-) moves the cursor, character by character, to 
the right 
>) moves the cursor, character by character, to 


the left 


72 


Working with RT—11 


(fT) 
(1) 


(ADVANCE) 


(BACKUP) 


(BLINE) 
(CHAR) 


(CUT) 


(DELCHAR) 


{DELEOL) 


(DELETE) 


(DELLINE) 


(DELWORD) 


(EOL) 


(FINDNEXT) 


(GOLD) 


{GOLD)(BOTTOM) 


(GOLD)(CHNGCASE) 


{GOLD)<FIND) 


(GOLD)(OPENLINE) 


{GOLD){PASTE) 


{GOLD)(SPECINS) 


{GOLD)TOP) 


moves the cursor, line by line, upward 
moves the cursor, line by line, downward 


sets the direction (forward) in which the cur- 
sor will move 


sets the direction (backward) in which the 
cursor will move 


moves the cursor to the beginning of a line 
moves the cursor in units of characters 


removes a selected section of text from a file 
and stores it in the paste buffer 


erases the character at the cursor 


erases forward from the cursor to the end of 
the current line 


erases the character preceding the cursor 


erases forward from the cursor to the begin- 
ning of the next line 


erases forward from the cursor to the first 
character of the next word 


moves the cursor to the end of a line 


searches for the next occurence of the search 
target, must be used after (GoLp)FinD) 


allows you to use the alternate functions of 
keys on the keypad 


moves the cursor to the end of a file 


changes single letters or letter contents of a se- 
lect range from uppercase to lowercase or low- 
ercase to uppercase 


(used with (apvance) or (BackuP)) selects a word or 
character as a search target, then searches for- 
ward or backward for the target 


inserts a blank line 


inserts the contents of the paste buffer to the 
right of the cursor 


inserts characters in ASCII 


moves the cursor to the beginning of a file 


References 
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{GOLD)(UNDELCHAR) 


{GOLD)(UNDELLINE) 


{GOLD)(UNDELWORD) 


(HELP) 


{LINEFEED) 


(REPLACE) 


(SUBSTITUTE) 


(WORD) 


restores the last character deleted from the file 


restores the last line of text deleted from the 
file 


restores the last word deleted from the file 


displays keypad functions and editor SET 
functions and explains errors made when a 
keypad function is used incorrectly 


erases backward from the cursor through the 
first character of the current or preceding 
word 


erases a selected section of text and inserts the 
contents of the paste buffer in its place 


accomplishes both the REPLACE and FIND- 
NEXT functions 


moves the cursor in units of words 


PDP—11 Keypad Editor User’s Guide provides a detailed 
discussion of KED. 


PDP-—11 Keypad Editor Reference Card. 


Basics of the Single Line Editor 
Starting and Stopping 
Finding the Functions 
Using SL LEARN to Retain the HELP Display 
Using the GOLD Key to Perform Alternate Functions 
Moving the Cursor 

Performing Operations with the Single Line Editor 
Deleting and Restoring Characters 
Exchanging Characters 
Executing a Command Line 
Retrieving Commands 

Simple and Complex Commands 

Digital Command Language 

Commands That Run Utility Programs Directly 
Command String Interpreter 
Concise Command Language 

Using DCL and CCL to Compare Two Versions of a File 

Screening of Monitor Commands 

Selecting the Type of Command to Use 

Summary 

References 
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Editing and 
Issuing Monitor 
Commands 


Monitor commands are commands you type in at your ter- 
minal in response to the dot prompt from KMON. You have 
already used some monitor commands like EDIT, COPY, 
DIRECTORY, and RENAME. To edit monitor commands, 
you will use the single line editor (SL). SL is available on 
Professional 300 terminals and on video display terminals 
that are compatible with the VT100. 

The single line editor allows you to move the cursor 
within a command line and to delete and replace charac- 
ters while you are interacting with the monitor. Using SL 
saves retyping commands in full when you make a mis- 
take, and it is also useful if you are running a program 
which needs data typed in line-by-line. 

This chapter also examines the three ways in which 
commands may be given to the monitor and discusses when 
to use each type of command. 

When you have completed this chapter, you will be 
able to start and stop SL; get the SL HELP display; move 
the cursor to the left and right; delete, restore, and swap 
characters; and execute all or part of a command line after 
using SL. You will also learn to cite the difference between 
commands written in Digital Command Language (DCL), 
Command String Interpreter (CSI), and Concise Command 
Language (CCL). 

ae ae ee ee ld a a a 
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Basics of the Single Line Editor 


Much of the time you are using RT—11, you will be issuing 
monitor commands. If you are typing long or complex 
monitor command lines you may find that you make typ- 
ing mistakes. Without using the single line editor (SL) there 
are only two ways that you can change a line: you can use 
the (oetetey key to erase one character at a time to the left of 
the cursor, or you can use the craw) key combination, which 
erases the entire line, so that you can retype it. 


Starting and Stopping 


Before you can use SL you must specify your terminal type. 
. EXAMPLE | . ) 
it you have a VT102 2 terminal, the command is: : 


ee ESET sl T4102 (tum) one 


If you are using a VT100 terminal, you need not give this 
command since VT100 is the default terminal type. You start 
SL by typing the command, SET SL ON. To stop SL, the 
command is, SET SL OFF. The commands to specify the 
terminal type and to start or stop SL can be combined into 
one command line. 


eruserenenmen meer AO ae HO EM UI MPO PP AEM NEP te mR ERE PT ER PO 


poe eee 
een ante Sere. | 


The ON or OFF part off the command must be the last 
element in the command line if commands are combined 
in one line. 
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Finding the Functions 


When you have issued SET SL ON, you can get a display 
showing the position of the SL function keys by pressing 
(Help). The location of the function keys on the VT100 and 
Professional 300 keyboards are shown in figures 8 and 9. 
The keys on the left-hand side of the diagram are on the 
main keyboard, and the keys at the right of the diagram are 
on the keypad. The characters and numbers in the center 
of the keys are the labels that actually appear on the keys; 
while the terms above and below them indicate the SL 
functions. 


Using SL LEARN to Retain the HELP Display 


Practice 
5—1 


If you are using a terminal that belongs to the VT100 or 
Professional 300 family, SL has a special feature to help you 
become familiar with the position of the keys. When you 
type the command, SET SL LEARN, and press «etr), the HELP 
display will stay on the upper half of your screen even if 
you type (return) a number of times. The LEARN feature al- 
lows you to keep the HELP display on your terminal screen 
for as long as you need it. To remove the HELP display, 
give the command, SET SL NOLEARN, which returns the 
terminal to scrolling normally. 


Type the command: 
SET SL LEARN(RETURN) 


Press (HELP); then press (RETURN) several times to see what 
happens to the HELP display. 


Remove the HELP display with the command: 


SET SL NOLEARN(ETURN) 


BELeEntEe ee, 
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The HELP function is also useful if you make an error 
using SL. When the bell rings after you make an error, you 
can press (Het) to get an error message. Press (hetr) again, and 
you will get the (etr) display. 

To resume editing the material in your file use (ctrur). 
Pressing any key will bring your text back onto the screen, 
but unless it is (ctrur), the character you press will appear 
in the text. 


Using the GOLD Key to Perform Alternate 
Functions ; 


As with the keypad editor, (coin), when used by itself, does 
not perform a function. However, when used in combina- 
tion with another function key, it directs SL to perform a 
specific function. If you press a function key without first 
pressing Gow), the function at the top of the key is per- 
formed (see figures 8 and 9). But if you press (cov) and im- 
mediately press a function key, the alternate function, noted 
at the bottom of each key, is performed. 


Moving the Cursor 


You can also use the arrow keys with SL to move the cur- 
sor to the left or right one character at a time. To move the 
cursor to the beginning or end of a line of text you can use 
the BEGIN or END functions. To get these functions you 
must press Go.o) before pressing either (4 or ©). 


Performing Operations with the 
Single Line Editor 
Deleting and Restoring Characters 


You can delete and restore text by character or by line. (oe- 
LETE) erases text one character at a time, starting from the last 
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character typed. All or part of a line of text can be erased 
by using (ctruu) OF (DELLINE). (cTRUU) erases a line of characters to 
the left of the cursor. (oe.uNne) erases a line of characters to 
the right of the cursor. 

If you find you have erased text by mistake, you can 
restore it in the unit of a character or of a line by pressing 
(GOLD)UNDELCHAR), (GOLD)(CTRUU), OT (GOLD)(UNDELLINE). 


Exchanging Characters 


The SWAP function allows you to switch the positions of 
the character at the cursor and the character to the right of 
the cursor. The cursor remains with the same character in 
its new position. The UNSWAP function switches the po- 
sitions of the character at the cursor and the character to 
the left of the cursor. These functions are found on (sackspace) 
on the VT100 keyboard, and on (12) on the Professional 
keyboard. 


EXAMPLE | se | 
_.- In the examples which follow, the underlined charac- ee 
| ter indicates the position of the cursor. celk tae 
| »-DIR/PROTEC1 TON(swap) 
‘produces: . 


_DIR/PROTECTION 


ili sa aan Si IN A tA 8S i EN RAISE SHE SEUSS Nin wi NM Re i i ga i BAT eB 


Seinen 


Executing a Command Line 


When you have completed the changes you want to make 
in a command line, you can execute the command by 
pressing return. You can execute part of the command, from 
the left margin to the cursor, by using the TRUNC function, 
that is, by pressing (cow) followed by return). 
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“EXAMPLE 
a ‘Tf you ioe the corataanid string: 


: .COPY. DXO:* MAC DX1: * BAK 
~~ DLI1: ‘FILES. BAK 


be, and you move > the cursor to the D in ‘DLA: ao 


«COPY DxO: * -MAC DX1: * BAK 
DLA: ‘FILES. BAK | 


fee you can execute the command: | 
-COPY DxO: +. MAC DK1: 8. BAK | 


: 2 by) pressing (GOLD)TRUNC), 


PEL AAAS ae wea eden enn nek abciaw Sum Sinn Damcniis Repeats pik i veal ait Rand Sinner ils iN ci Aas asi cliiody 


pace ste rererenerecemt ern IE A NS SRI EIR ER MOEN CORINTH RENEE NI AME EO AE OH 


Ab ea NSE RSS EG RNS: ANIM IR Bet iD ce aN ERE Ha BE Te LBRO ORA A Ad RAREST CANS ORE RE RE BEATE SEY CAME ESET A TO 


Retrieving Commands 


Practice 
5-—2 


The GET OLD function, obtained by pressing (co.p) and then 
(1) displays the command most recently typed at your ter- 
minal. You can then edit the command as if you had just 
typed it. (If you are using RT—11 version 5.1 on the Profes- 
sional computer, you simply press (+) to obtain the GET OLD 
function while in SL. Pressing (cout) activates the GET 
OLDER function, which displays the second-to-last com- 
mand for you to edit.) 


Enable SL by typing: 
SET SL ON(RETURN) 


Set it to the LEARN option so that the HELP display 
remains on the screen. Type in the command: 


DIR/PROTECT I ON(RETURN) 


Use the GET OLD function to reproduce the command 
line. Change the command to: 


DIR/NOPROTECT I ONcRETURN) 


Chapter5 Editing and Issuing Monitor Commands 83 


by moving the cursor and typing in the extra charac- 
ters. Execute the command. 


Use the GET OLD function to redisplay the command 
line. Delete DIR;/NOPROTECTION, with (deLtiney and 
type in the following command line exactly as it is 
shown here: 


DIR/ALPHABETIZE/RIEBF/CLMNSOU: 3/DEELTED 


Use the SWAP and UNSWAP functions to alter the 
command line so that it reads: 


DIR/ALPHABETIZE/BRIEF/COLUMNS: 3/DELETED 


Remember that (6oLp)UNswaAP) moves the character at the 
cursor position to the left, (swap) moves the character to 
the right. Execute the command. 


Use the GET OLD function to reproduce the command 
line. Move the cursor to the slash after the command 
word DIR and use (TRUNC) to execute the first part of the 
command line and get a complete directory listing. 


The REFRESH function— obtained by pressing (ctruw or 
(ctavk)— displays the current line of text on your video screen. 
REFRESH is useful if you are not sure that your screen is 
displaying information accurately, or if another job prints 
a message on your screen while you are typing a command 
line. When you press (ctauvr) or (cTRUW), the system removes 
any interrupting message or data and redisplays the line you 
are typing. 


Simple and Complex Commands 


Keyboard monitor commands can be simple or complex. The 
distinction is based on the way in which the commands are 
executed rather than on the difference in the format of the 
command. When you issue a simple keyboard command, it 
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is executed directly by the keyboard monitor, KMON. Sim- 
ple commands include LOAD, SET, DATE, and TIME. 


= ‘EXAMPLE ie ee ae oe = ed 
TIME. 10: 82: : 03 GETIN) 


awit mee sae re ee ce ee ee ee aes ee eee et ee ee eee ee re oe eS em ee | 


Complex commands are not executed directly by the 
keyboard monitor. Your RT—11 system has utility pro- 
grams to perform functions like creating, deleting, or com- 
paring files. The keyboard monitor has to call these utility 
programs to perform the operations. 

When you issue a complex command, KMON auto- 
matically expands the command to run a utility program 
and gives the utility program the file specifications and op- 
tions. 


esse ernest eto rt na mmm eR ements tn ener pment ren mney 


If you issue the command: 


Fe eee ee oe ee 


oS sCOPY. INPUT. TMP OUTPUT. TMP ( (TURN) 
KMON will cpa it to: #6 


—R PIP_ 
_ sourPUT. TMP = INPUT. TMP 


Ft aires aed: osetia cama arene aeeamre earn ee 
‘et. ee Po i : ee 
fe J aed 
: 3 


re ee er rer wer cn nnn enon ener net tee mre ere 


So, when you use complex commands, you are calling and 
running utility programs. In order to run a utility program, 
the system must receive the command, file specifications, 
and options in a format it can understand. The examples 
above illustrate simple and complex commands written in 
the Digital Command Language (DCL) format. 


Digital Command Language 


The easiest and most convenient command string format to 
use is Digital Command Language, which works through the 
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keyboard monitor. You do not need to know the name of 
the utility program being used. Instead, you use a word (one 
of more than a hundred standard DCL commands) which 
approximates the name of the task you are trying to accom- 
plish. Once your command has been entered, the system 
prompts you for file names or other necessary information. 


EXAMPLE 


| - COP Y(RETURN) 
From? OLD. TXT return) 
To 2 NEW. TX Tcreturn) 


Or you can use the short format: 


| COPY OLD. TXT NEW. TXT«Retuany 


insane ste oS en inn ea NSE AA Et Bel naa ea na aprocinsen tag ett Sek dnt Da eeS oR i REESE MA yaaa UNI HMA TIES SE RER EAA MSE CA HERES 


fame 


All the monitor commands introduced in this book so far 
have been DCL commands. The two sections which follow 
describe other ways to run utility programs. 


Commands that Run Utility 
Programs Directly 


Command String Interpreter 


The Command String Interpreter (CSI) runs utility pro- 
grams directly. CSI, known as a parsing utility, is older and 
less convenient to use than DCL. It consists of typing R (a 
run command not to be confused with the DCL command, 
RUN) followed by the name of the utility program. 


EXAMPLE | 3 oo 
RPI P return) 


hci fe RAN ES NN IA SABE Hi Ga EAP AE BEAT DEE NERD EERE ATE EEG EEO EEE IE AMEE EE RMSE ADEM EET ENE SEE LEE ERT EE OER ERE ED 


RT—11 responds to this command to run the peripheral in- 
terchange program by giving you an asterisk prompt. You 
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can then type in the file specification in the correct format. 
When the material in the old file has been copied into the 
new file, the system sends an asterisk prompt, which means 
that you are still in the utility program rather than KMON. 
At this time you can use PIP again simply by typing in the 
file specification and options you need. 


snes sareinngwe tet mention eisai nng Unmet hn ae ERM EMA IRC NS OE Ec ta eae 


Eerste menor rete entn nme 
‘ # ee 
: ‘ 4 
i t 

5 


EXAMPLE, 0 SE RGA 
S RP ITP RETURN) “ Sais : a oe ae a 
#NEW ST XE SOLED OT XT RETURN). oe : 


* 


You press (ctruc) to return to KMON when you are finished. 


Concise Command Language 


Ee aeiaaaer eee 
% 

ee t 

z a 


eitemrer genre reenact 
Fees 


EXAMPLE — 


— *NEW. TXT=OLD. TX Tareturn) 


: oy 


Concise Command Language (CCL) also runs utility pro- 
grams directly and uses the CSI syntax but without the R 
command. 


mpenucton tase ean ance munca 


. P I P(RETURN). 


ee ee eee ee 


CCL allows you to use two other formats to simplify the 
command string: 


PIP NEW.TXT=OLD.TXT 
or 


PIP OLD.TXT NEW.TXT 


The second format omits the equal sign and therefore re- 
quires a different order in the file specification. In each case, 
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system control returns to KMON when the command has 
been executed. When issuing CCL and CSI commands, you 
must supply the name of the utility you are using in each 
command line. 

In addition to DCL, CSI, and CCL, RT—11 provides you 
with a facility called user command linkage (UCL). UCL is 
a system generation option that allows you to write your 
own program (UCL.SAV) to interpret and process addi- 
tional commands. 


Using DCL and CCL to Compare Two 
Versions of a File 


Suppose you want to compare the contents of two files. In 
Digital Command Language, you would use the DIFFER- 
ENCES command. 


EXAMPLE 7 | 


. DI F (RETURN) 
File 1? US0801. TMP return) 
File 2? US0801.BAK«RETURN) 


The short command format for this command is: 


-DIF US0801.TMP US0801. BAK (RETURN) 


A list of the differences between the files would be printed 
at your terminal. 

To compare two files using CCL, you must supply the 
name of the source comparison utility program, SRCCOM. 


EXAMPLE 
.SRCCOM US0801.TMP,US0801 . BAK«return) | 


ii OTe i TN HSER OOS ec he IO EI Rei NMI AEE OEE BRERA ES TERE RE Sta Binaries RI a MES MEE ee eres 


RT-11 runs the SRCCOM utility program regardless of the 
type of command (DCL or CCL) you use. 
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Figure 10. 
Issuing a Monitor Command 


DCL 


IS ITA 
DCL COMMAND? 


PROCESS 


NO 


ENTER COMMAND 
ON KEYBOARD 


CCL 


IS THERE A 
PROGRAM XYZ.SAV? 


XYZ RUN XYZ. SAV 


NO 


UCL 


DOES PROGRAM 
UCL.SAV EXIST? 


}no 


RUN UCL. SAV 


ERROR MESSAGE 


Screening of Monitor Commands 


The sequence of events that occurs when you issue a mon- 
itor command is shown in figure 10. The keyboard monitor 
tries the input string against each type of command in turn 
to check whether or not it is a valid command. As figure 
10 shows, KMON goes through a fixed sequence to check a 
command. 


Selecting the Type of Command 
to Use 


You can take advantage of nearly all of the capabilities of 
RT—11 by using DCL commands. However, you may choose 
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to access and run utility programs directly, using CCL or 
CSI, on occasion. 

If you are a systems programmer and need to use fea- 
tures of the utility programs not accessible from DCL, you 
would select CCL. If you have used an earlier version of 
RT-11 or another operating system such as RSTS or OS/8, 
you may prefer CCL because you are accustomed to run- 
ning utility programs directly. If you need to use the same 
utility several times—say, to copy a large number of files— 
accessing the utility program directly would allow you to 
type in only the names of the files instead of repeating the 
entire command. 

In general, DCL provides the simplest way to access 
the utility programs. The long format of DCL is particularly 
useful because it prompts you for the information needed. 
For this reason, the next chapter focuses on using Digital 
Command Language to run utility programs. 


Summary 


COMMANDS USED WITH THE SL EDITOR 


SET SL LEARN _ (used with the HELP key) keeps the HELP 
display on the upper half of the screen 


SET SL OFF stops the single line editor 
SET SL ON starts the single line editor 


FUNCTION KEYS USED WITH SL 


(-) moves the cursor one character to the left 

(>) moves the cursor one character to the right 

(CTRUR) redisplays the current line of text 

(CTRUU) deletes the line of characters to the left of the 
cursor 

(CTRUW) redisplays the current line of text 

(DELETE) deletes each character to the left of the cursor 

(DELLINE) deletes the characters from the cursor to the 


end of the line 
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(GET OLD) 


{GOLD)<BEGIN) 


(GOLD){CTRU/U) 


{GOLD){END) 


{GOLD){GET OLD) 


(GOLD)(GET OLDER) 


(GOLD)TRUNC) 


{GOLD)(UNDELCHAR) 


(GOLD)(UNDELLINE) 


{GOLD)(UNSWAP) 


(HELP) 


(RETURN) 


(SWAP) 


(on the Professional 300) redisplays the com- 
mand just typed at the terminal 


moves the cursor to the beginning of line 


restores the line of characters deleted with 
(CTRUU) 


moves the cursor to the end of a line 


(on the VT100) redisplays the command just 
typed at the terminal 


(on the Professional 300) redisplays the second 
to last command typed at the terminal 


executes the part of a command line to the left 
of the cursor 


restores the character deleted with (bELETE) 


restores the line of characters deleted with 
(DELLINE) 


switches the character at the cursor with the 
character to the left of the cursor 


displays the location of SL function keys and 
explains error messages 


executes an entire command line 


switches the character at the cursor with the 
character to the right of the cursor 


COMMANDS THAT RUN RT-11 UTILITY PROGRAMS 


Command String Interpreter (CSI) 
Concise Command Language (CCL) 
Digital Command Language (DCL) 


References 


RT-—11 System User’s Guide. Section 4 discusses editing 
command lines with SL. 


RT-—11 System User’s Guide. Chapter 4 lists and explains DCL 
commands in alphabetical order. 


RT-11 System Utilities Manual. Part 1 describes the utility 
programs available on RT-11. 
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Using 
Utility Programs 


The RT—11 system has a wide range of utility programs. 
You have used a small number of these by entering DCL 
commands. This chapter will expand your knowledge and 
allow you to make more efficient use of the system. 

The following sections group DCL commands accord- 
ing to the function they perform and describe options which 
can be used with more than one DCL command. The DCL 
commands discussed in this chapter are arranged accord- 
ing to these functions: file maintenance, editing and print- 
ing, file examination, and system operations. 

The relationship between DCL commands and utility 
programs is complex and therefore one DCL command may 
run one of several utility programs, depending on the op- 
tions selected. 

When you have completed this chapter, you will be 
able to use DCL commands to run utility programs that 
create, copy, delete, rename, or change the protection sta- 
tus of files; get directory listings; print files; or perform sys- 
tem operations such as SET and SHOW. 

Ee a a ag ge | 
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Utilities and Their Functions 


Listed below are some of the functions of utility programs. 
As you read through, look at the range and types of func- 
tions utility programs offer. The groupings of programs are 
broadly analogous to the groupings of commands you will 
be studying more closely in this chapter. 


File Maintenance 


PIP (peripheral interchange program) and FILEX (file ex- 
change) copy files. PIP transfers files from one device to 
another device on an RT—11 system. It also merges, re- 
names, deletes, and changes the protection status of files. 
PIP is one of the utility programs you use most often. FILEX 
converts files from one file format to another so that they 
can be transferred between, and used with different oper- 
ating systems. For example, FILEX can create and convert 
diskettes in IBM format, known as Interchange format, or 
transfer files from RT-—11 to DOS (disk operating system) 
format. 

BUP (backup utility program) copies a file or volume 
onto a number of smaller volumes for backup storage, and 
can restore files or volumes from these backup volumes. 

DUP (device utility program) is used to create files. DUP 
is also used to initialize storage media, to detect and cover 
or replace bad blocks and to copy the bootstrap to a new 
system volume. 

RESORC (resource utility) displays information about 
your hardware and software configuration at the console 
terminal. 

DIR produces directory listings. 


File Editing 


In earlier chapters you used one of the RT—11 text editors, 
KED. KED is really an option for the EDIT command. You 
call the text editor when you are at monitor level by using 
the DCL command EDIT/KED. 
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File Examination 


DUMP displays on the console or printer or writes into a 
file all or part of a file in binary or ASCII. 

BINCOM (binary file comparison) and SRCCOM (source 
comparison) are both used to compare files and list the dif- 
ferences between them. SRCCOM compares text files con- 
taining ASCII characters. BINCOM compares files contain- 
ing data in any binary form other than in ASCII. 


Program Development 


RT-11 provides facilities to transform a program so that it 
can be run. These include the linker utility, LINK, and lan- 
guage processors like MACRO—11, DIBOL-11, FORTRAN 
IV, and BASIC-11. 


File Maintenance Commands 


In chapter 3, ‘“‘Storing Data on Disks,” you used the follow- 
ing DCL commands: DIRECTORY, COPY, DELETE, RE- 
NAME, PROTECT, and UNPROTECT. Along with CRE- 
ATE, these file maintenance commands are the DCL 
commands you will probably use most often. In this chap- 
ter, you will be concentrating on the various options that 
allow these DCL commands to perform most efficiently. 
Options available for only one command are discussed in 
the section about that command. Except for CREATE, most 
file maintenance commands use similar options. 

The general syntax for a command string with options 
is: 

COMMAND/OPTION INFILE/OPTION OUTFILE/OPTION 

/OPTION represents a qualifier that tells the system 
either the exact action for a command or more detailed in- 


formation about a file. Any option you specify after a com- 
mand applies to the entire command string. 


Working with RT—11 


DIRECTORY: Listing the Files on a Storage 


Volume 


The DIRECTORY command, which elicits information about 
files on a storage volume, has a wide range of options. 
These options allow you to organize the information dis- 
played, select specific files to be listed, and find volume 
information. The /ALPHABETIZE, /SORT[:CATEGORY], 
and /ORDER[:CATEGORY] options allow you to change 
the order of a listing. /SORT[:CATEGORY] or /OR- 
DER[:CATEGORY] each sorts and displays the directory of 
a storage device according to a category you specify, for in- 
stance, by creation date, file name, file size, or file type. 
/COLUMNS:n (n can be any integer from 1 through 9) al- 
lows you to specify the number of columns in a directory 
listing. The default value for n is 2. 

The /DELETED option lists the files that have been de- 
leted from the device you specify. By supplying a file spec- 
ification, or simply a device name in the command line, you 
can get a directory listing showing the details of the file, or 
the files on the storage device you specified. 

The /BLOCKS option includes starting block number 
in the directory listing. You can use the /FREE option to 
get a listing of the unused areas and their size. 

The DIRECTORY command runs the utility program 
DIR. You can specify more than one option in the com- 
mand string. 


bee. EXAMPLE ere 8 
ee : You may want a A ecaey listing that chows thee a 
' block address of ales. on DXO: in. elnbabetic.c order. s oe 
| The command ists 3. oe ee nes ue ee 

DIRECTORY /ALPHABET1ZE/BLOCKS x0: (RETURN oe 
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COPY: Making Copies of Files 


The COPY command which transfers files or the contents 
of a specified volume from one location to another, has a 
wide selection of options (see table 11). 
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Table 11. 
COPY Command Options 
/ALLOCATE:size /NEWFILES 
/ASCII /OWNERT[:nnn,nnn] 
/BEFORE[:date] /PACKED 
/BINARY /POSITIONS:n] 
/BOOT{[:dev] /PREDELETE 
/CONCATENATE /PROTECTION 
/DATE[:date] /NOPROTECTION 
/DELETE /QUERY 
/DEVICE /NOQUERY 
/DOS /REPLACE 
/ENDO:n /NOREPLACE 
/EXCLUDE /RETAIN 
/FILES /SETDATE[:date] 
NGNORE /SINCE[:date] 
[IMAGE /SLOWLY 
/INFORMATION /START:n 
/[INTERCHANGE[:size] SYSTEM 
/LOG /TOPS 
/NOLOG /VERIFY 
/MULTIVOLUME WAIT 

_ EXAMPLE 


The DCL command: 


»-COPY/NEWFILES D21:*.* D2Z0-: (RETURN) 


- copies all files with the current date from drive DZ1 


to DZO. 


I eat enone aii 
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One of three utility programs—PIP, FILEX, or DUP— 


may be run when the COPY command is issued, depend- 
ing on the options you specify. 


CREATE: Creating or Extending Files 


The CREATE command creates or extends a file with a spe- 
cific name, location, and size. You use the EDIT command 
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DELETE: Erasing 
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with the /CREATE option to start a new text file, but you 
issue the monitor command CREATE to restore a deleted 
file. The two are not related. 

When you delete a file, the directory entry for the file 
is deleted. This means that the blocks on the volume can 
be used for another file, and the contents of the file can be 
written over. If you use the CREATE command to restore a 
file as soon as you have deleted it, then the blocks holding 
the file will not yet have been written over. To create a di- 
rectory entry for the file you have deleted in error, you will 
need to specify the starting block number of that file and 
its size. The CREATE command options /START:n and 
/ALLOCATE:size allow you to supply this information. You 
should be cautious when using CREATE to restore a file. 
The directory may not list the starting block number or size 
of the most recently deleted file if that file is stored be- 
tween two files that have been deleted previously. 

Another create command option is /EXTENSION:n. Use 
this option to extend an existing file by the number of blocks 
you specify. The /EXTENSION:n option follows the file 
specification. 


rig tot a NN SMP MD ren tm mY ea He tere eo ye ls mre mie horsemen 


Ee _ EXAMPLE | : 

| oe CREATE. DXO:TEXT. TMP /EXTENSION: 2 O;RETURN) 
i 

8 

: 


This command extends the file named TEXT. TMP bys j 
20 blocks. : a 


oe sii ac a ae SA ne nn aR a pe Re oD ti gw aR St a a HOE as A A aR IE ENON REA 


When you use this option, make sure that there is enough 
unused space on the volume for the size you specify. (You 
can use the DIRECTORY/FULL command to check the 
amount of space available.) 


a File 


The monitor command DELETE, which erases the files you 
specify, has several options (two of which are presented 
here). 
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/NEWFILES is an option you use to delete files that have 
the most recent system date. It is a convenient way to re- 
move all the files you just created in a session at the com- 
puter. 


EXAMPLE 


-DELETE/NEWFILES DY1:*. BAK(RETURN) 
Files deleted: 

DY1:TEXT.BAK ? Y (RETURN) 
DY1:MYFILE.BAK 2? Y(RETURN) 


2 
Ea 
Riecniee seeee i tt mieten in 2 


The command issued in the example above told the system 
to delete all the backup files created today. The command 
given in the example below tells the system to delete all 
the files from DYO: except those with the file type .SAV. 


EXAMPLE 


~.DELETE/EXCLUDE .DY0O:%. SAV RETURN) 
?2?PIP-W-No .SYS action 

Files deleted: 

DYO0:ABC.QLD = ?. Y<RETURN) 
DYO:AAF.QLD~ ?  Y(RETURN) 
DYO:FILE.OLD ?  Y«ReTuRN) 


[ices at aia cnt ae Ni ont aie aN cao Nee aL a 


RENAME: Renaming a File 


The RENAME command, which assigns a new name to an 
existing file, has several options. /PROTECTION and /NO- 
PROTECTION allow you to protect or remove the protec- 
tion status from files using the RENAME command. /RE- 
PLACE is the default mode of operation for the RENAME 
command. If a file exists with the same name as the file you 
specify for output, the system deletes the duplicate file when 
it performs the rename operation. /NOREPLACE prevents 
execution of the rename operation if a file with the same 
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name as the output file you specify already exists on the 
same device. 


PROTECT and UNPROTECT: Preventing 
Accidental Deletion 


The PROTECT and UNPROTECT commands have various 
options including /BEFORE, /DATE, /NEWFILES, /SET- 
DATE, /SINCE, /EXCLUDE, /QUERY, /SYSTEM, /INFOR- 
MATION, /LOG, /NOLOG, and /WAIT. These options are 
described in the next section. 


Common Options for File 
Maintenance Commands 


The options discussed here can be used with more than one 
DCL command. In particular, they often accompany file 
maintenance commands. Table 12 lists these options and 
the commands they qualify. 


Table 12. 
DCL File Maintenance Commands with Common Options 


Commands 


COPY DELETE DIR PROTECT RENAME 


Options 


/BEFORE[:date] 
/DATE[:date] 
/EXCLUDE 
/INFORMATION 
/LOG 

/NOLOG 
/NEWFILES 
/QUERY 
/SETDATE[:date] 
/SINCE[:date] 
/SYSTEM 
WAIT 
/POSITION:n 


* * * * * 
* 


* * * * * * * * * * * * 


* * * * * * * * * * * * + 
* 
* * * * * * * * * * * * 


* * * * 
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Selecting Files By Date 


Files are stored with their creation dates in the directory. 
You can use the creation date of your files to select a group 
of files to operate on; for example at the end of a working 
day you may want to copy all the files you have created 
onto another storage device. A range of options use the cre- 
ation date as a way of selecting files. 


/BEFORE [:date] selects all files created before a speci- 
fied date 


/DATE [:date] selects all files with the creation date 
you specify (if you do not specify a 
date, then the current system date is 
used) 


/NEWFILES selects only those files with the cur- 
rent date 


/SETDATE [:date] _—_ assigns the date you specify to all 
files on which the command is per- 
formed 


/SINCE [:date] selects all the files created on or after 
the date you specify 


Selecting Specific Files 


As you know, if you use wildcards in the file specification, 
the system allows you to select specific files, or questions 
you before operating on each file that matches with the 
wildcard. The following options work similarly. 


/EXCLUDE selects all files on a device except the ones 
you specify (you can use wildcards in the 
file specification) 


/QUERY instructs the system to request confirmation 
before carrying out the command (if you use 
wildcards in the file specification, this op- 
tion allows you to check which files are op- 
erated on) 
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SYSTEM 


selects files with the file type SYS if you 
have used wildcards in the file specification 
(unless this option is used, files with the file 
type .SYS are usually not operated on) 


Displaying Information about Selected Files 


These options give more information about the files on 
which the command operates. If you use wildcards in the 


file specification, 


you will find these options useful. 


AINFORMATION _ allows processing of a command to 


/LOG 


/NOLOG 


continue after an error is found 


lists the files on which the command 
operated (without this option, the sys- 
tem only prints a list of files operated 
on when there are wildcards in the 
file specification) 


reverses the /LOG option, so no infor- 
mation about files operated on is dis- 
played. 


Applying Commands to Specific Devices 


The following options are used for device specific opera- 


tions. 


‘WAIT 


/POSITION:n 


instructs the system to initiate the com- 
mand you issued but to pause and wait 
for you to mount the volume containing 
the files you want processed (this option 
is useful if your system has only one disk 
drive) 


specifies the block address from which to 
start searching for a file (this option is for 
use with operations on magnetic tapes). 
/POSITION:—1 is used to continue from 
the current position 
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Practice In this exercise you will use file maintenance commands 
6—1 and some options to manipulate files. 


1. Create a text file called FILE.TXT using a text editor. 
2. Protect FILE.TXT with the command: 
PROTECT FILE. TXT «return) 


You can unprotect a file, rename it, and protect the re- 
named file in one step with the RENAME command 
and /PROTECTION option. Type: 


RENAME/PROTECT FILE.TXT US0O901 . TX T«RETURN) 


Try to delete the file US0901.TXT. You should get an 
error message like the following: 


?PIP-W-Protected file DL0:US0901.TXT 


Commands for Editing and Printing 
Files 


Printing Files on a Line Printer 


The PRINT command lets you print files on a line printer. 
It runs the utility program PIP. You can name up to six files, 
separated by commas, in a command string. Wildcards can 
also be used with the PRINT command. PRINT options in- 
clude /BEFORE, /DATE, /INFORMATION, /LOG, /NOLOG, 
/NEWFILES, /SINCE, and /WAIT. 


Practice If you have a line printer, use the PRINT command to pro- 
6-—2 duce a hard copy of the file US0901.TXT. Type the com- 
mand: 


-PRINT US0901. TX T(RETURN) 


104 


Working with RT—11 


Typing Files at the Terminal 


Practice 
6-3 


The TYPE command displays the contents of a text file on 
the terminal. It also runs the PIP utility program. Use this 
command when you want to examine a file. Remember that 
you can use (cTrus) and (ctava) to stop and start the file listing 
at your terminal and ctrvo) to prevent the listing from being 
displayed. If you are working at a hard copy terminal, you 
would use the TYPE command to produce a listing of your 
file. 


Use the TYPE command to display the contents of 
US0901.TXT at your terminal. 


File Examination Commands 


DUMP: Printing Files on the Terminal or 


Line Printer 


The DUMP command allows you to examine directories and 
files. Output can be printed on the terminal or line printer, 
or written to a file in octal words, octal bytes, ASCII char- 
acters, or Radix—50 characters. The DUMP display will be 
useful for debugging when you are more familiar with the 
RT-—11 system. Figure 11 shows part of a dump of a text 
file. The /TER option used here specifies that the dump 
should be output at the terminal instead of at the line Panter, 
the default output device. 


DIFFERENCES: Comparing Files 


The DIFFERENCES command lists the differences between 
files. It may be used when you want to compare two edi- 
tions of the same file, for example, to see what changes have 


Figure 11. 


RKUSUSOIUL. ERAT 


SLUCK WUMBER 


QO00/ 
020/ 
us07 
0607 
1.0/ 
120/ 
140/ 
Loos 
200/ 
220/ 
240/ 
200/ 
30U/ 
$207 
340/ 
300/ 
4U00/ 
42G/ 
94uU/ 
400/ 
500/ 
520/ 
540/ 
560/ 
o00/ 
620/ 
040/ 
boi)/ 
7TV00/ 
720/ 
1407 
760/ 


3buCK NUMBER 


000/ 
O20/ 
940/ 
uo0/ 
1U00/ 
120/ 
140/ 
100/ 
2V00/ 
220/ 
240/ 
200/ 
300/ 
320/ 
340/ 
360/ 
400/ 
420/ 
440/ 
460/ 
5007 
520/ 
540/ 
560/ 
600/ 
620/ 


020040 
072160 
026524 
020144 
0603040 
072455 
O71571 
020520 
067151 
0201604 
071541 
071440 
u72055 
072141 
U20103 
064564 
061541 
062543 
026144 
071160 
067145 
062571 
06244U 
071157 
067151 
026520 
000567 
066015] 
060567 
062564 
002554 
071544 


071556 
v62157 
071040 
074145 
060440 
005015 
071141 
062554 
020001 
051524 
067523 
067151 
030455 
067141 
061564 
074563 
020054 
060543 
061455 
062566 
061440 
071157 
061440 
070160 
063040 
073145 
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v00000 


020040 
067551 
030461 
067504 
071541 
062563 
062504 
030461 
061551 
060567 
060449 
O71571 
066551 
067551 
Vo00564 
067157 
072501 
0715603 
006440 
063557 
027164 
071141 
061570 
072040 
072544 
030461 
0201603 
020144 
020163 
020162 
000440 
00744u 


072101 
020155 
073440 
061040 
026164 
06744) 
020155 
063040 
066557 
020163 
071440 
062564 
020145 
060556 
063502 
020163 
971551 
061440 
007412 
060562 
005015 
03044U 
072151 
062550 
072163 
006440 
067157 
067141 
060555 
067560 
063012 
020146 


O00u001 


073440 
061505 
066145 
062560 
0607151 
020040 
020145 
063040 
007543 
024040 
072146 
0660143 
U51461 
020144 
026550 
072163 
0604164 
066154 
071557 
07144 
072557 
071040 
066557 
064554 
071157 
066145 


u72151 
064544 
072141 
071556 
061551 
020040 
964164 
071157 
071556 
060520 
060507 
0621605 
040440 
047504 
071157 
066545 
020145 
002145 
026164 
071571 
062154 
060545 
072560 
060543 
006440 
070157 


Dump of US0901.TXT 


064440 
067152 
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006440 
06256U 
067546 
066541 
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Vo7T15Si 
020155 
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072151 
067157 
020146 
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005015 
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0607151 
061440 
074562 
061412 
074554 
v20144 
064553 
062567 
071157 
070141 


020150 
067157 
073151 
v73151 
066557 
052040 
067145 
072040 
071551 
062560 
062562 
062145 
011563 
026523 
062551 
027051 
0604563 
06304y 
064440 
062564 
061040 
026554 
0005604 
064564 
070012 
062555 


071564 
030440 
062040 
v20i141 
v02412 
VoU05S62 
020162 
066151 
062564 
062566 
0060147 
067546 
020144 
072412 
060440 
062562 
067551 
071164 
067543 
062544 
020049 
020061 
020147 
0660557 
020056 
0660557 
000440 
044504 
063556 


020162 


072040 
066100 


064164 
067440 
066145 
020145 
072560 
062550 
U00440 
062550 
0625604 
020162 
020054 
072040 
060545 
030461 
072156 
041440 
072564 
071157 
072156 
020155 
020145 
064564 
0604564 
v67157 
067562 
072156 
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001440 
033471 
071545 
066563 
071541 
064564 
0641604 
020171 
0715602 
067554 
020145 
020162 
007543 
062563 
070160 
0602040 
U20156 
060157 
071165 
062566 
620040 
0005607 
064564 
07256U 
064124 
072500 
074440 
044507 
0601440 
062546 
0607550 
Oo1551 


02u145 


020146 


020171 
033vU61 
062564 
071440 
0600566 
050040 
020144 
060524 
0604167 
662550 
066142 
024040 
072141 
062554 
072141 
060440 
071145 
005015 
071565 
062555 
067157 
026163 
071147 
020056 


0607157 
026062 
063551 
066141 
026571 
063556 
uz0145 
063157 
000456 
U62560 
071565 
062562 
070155 
020073 
v04554 
072141 
070040 
020054 
062563 
067554 
004124 
020163 
062555 
062564 
020145 
062564 
vo0545 
040524 
066557 
071541 
Uu71565 
072141 


0607151 
v64164 
005015 
061055 
027162 
063157 
Obo151 
050104 
063157 
062560 
061551 
050040 
071145 
020141 
062145 
071141 
067551 
066040 
061541 
064164 
062145 
000440 
066141 
060440 
0660541 
000000 


062543 
051049 
062556 
026154 
V67564 
071440 
042120 
060440 
044412 
020144 
071145 
066141 
072165 
072151 
060543 
020141 
067562 
067141 
020054 
Ub6560 
020145 
067141 
063040 
02U162 
042120 
020162 
020162 
020114 
072560 
061151 
0607141 
067551 


O711l04 
O71551 
067151 
U72151 
005015 
073564 
061141 
030455 
050u4uU 
v05015 
020150 
046101 
020051 
060542 
005015 
074554 
020156 
073557 
064564 
072141 
063040 
062156 
060440 
062156 
0620490 
000000 
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been made while editing. In the last chapter, you used the 
DIFFERENCES command to run the SRCCOM utility pro- 
gram. 


System Function Commands 


SET: Changing Editors, Terminals, or 
Physical Devices 


You may have used the SET command to change the de- 
fault editor, to change terminal characteristics (SET TT 
NOSCOPE) or to enable the single line editor (SET SL ON). 
You can use the SET command to change the characteris- 
tics of physical devices, and of system parameters. SET USR 
NOSWAP, for example, causes the User Service Routines 
module to remain resident in memory. SET LP LC enables 
lowercase characters to be printed on a line printer equipped 
with lowercase type. The SET command is executed by the 
RT-—11 monitor, and does not cause a utility program to run. 


SHOW: Getting Information about RT—11 


The SHOW command prints information about your RT— 
11 system on the terminal. 

The SHOW command can give you information about 
your hardware configuration, which version of the monitor 
you are using, and so on. Options allow you to select de- 
tails about specific parts of your system. 


EXAMPLE = | SS eas 
—.SHOW MEMORY@eTuRN 


Address “Module Words 


rasan me tenn ent cma aman noe aa 


160000) 1DPAGE, < | 4096. 5 3g 
457400 52 RK erties) 20 va ene 


scneneatgreneesaemsees 


a ee ee ek ee ec ee Re eee ee ee ee ee ee ee ee 


Chapter6 Using Utility Programs 107 


The ALL option combines the information shown by CON- 
FIGURATION, DEVICES, JOBS, TERMINALS, MEMORY, 
and SUBSET. 


Summary 
UTILITY PROGRAMS 


BINCOM (binary file comparison) 
compares files containing data in any binary form 
other than ASCII 


BUP (backup utility program) 
copies a file or volume onto a number of smaller 
volumes for storage 


DUMP (dump utility) 
displays all or part of a file in binary or ASCII 
code 

DUP (device utility program) 


creates files, initializes storage media, and copies 
the bootstrap program onto a new system volume 


FILEX (file exchange) 
converts files from one format to another 


PIP (peripheral interchange program) 
copies files from one device to another device on 
an RT—11 system 


RESORC (resource utility) 
displays information about hardware and software 
configuration 


SRCCOM _ (source comparison) 
compares text files containing ASCII characters 


OPTIONS TO FILE MAINTENANCE COMMANDS 


COPY/NEWFILES copies only the files with 
the most current system 
date 

CREATE/ALLOCATE:size allocates the number of 


blocks you specify to the 
file you are creating 
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/EXTENSION:n 


/START:n 


DELETE/EXCLUDE 


/NEWFILES 


DIRECTORY/ALPHABETIZE 


/BLOCKS 


/COLUMNS:n 


/DELETED 


/FREE 


/ORDER[:CATEGORY] 


/SORT|[:CATEGORY] 


RENAME/NOPROTECTION 


extends an existing file 
by the number of blocks 
you specify 


specifies the starting 
block number of the file 
you are creating 


deletes all the files on a 
device except the ones 
you specify 


deletes only the files with 
the most current system 
date 


lists the directory of the 
device you specify in al- 
phabetical order by file 
name and file type 


displays a directory of 
the device you specify 
and includes the starting 
block number in decimal 
of all the files listed 


lists a directory in the 
number of columns you 
specify 


lists a directory of files 
that have been deleted 
from a specific device 


lists the unused areas on 
a device 


sorts the directory of a 
device according to the 
category you specify 


sorts the directory of a 
device according to the 
category you specify 


renames a file and re- 
moves the protected sta- 
tus 
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/NOREPLACE 


/PROTECTION 


Using Utility Programs 


109 


prevents execution of the 
rename operation if a file 
with the same name as 
the output file you spec- 
ify exists on the same de- 
vice 


renames a file and gives 
it protected status so that 
it cannot be deleted acci- 
dentally 


OPTIONS COMMON TO FILE MAINTENANCE COMMANDS 


/BEFORE[:date] 


AINFORMATION 


/LOG 


/NOLOG 


/POSITION:n 


/QUERY 


/SETDATE[:date] 


/SINCE[:date] 


SYSTEM 


/WAIT 


DCL COMMANDS 


DIFFERENCES 


selects all files created before a specified 
date 


allows processing of a command to con- 
tinue after an error is found 


lists the files on which the command oper- 
ated . 


reverses the /LOG option, so no informa- 
tion about files operated on is displayed 


specifies the block address from which to 
start searching for a file 


instructs the system to request confirma- 
tion before carrying out the command 


assigns the date you specify to all files on 
which the command is performed 


selects all the files created on or after the 
date you specify 


selects files with the file type .SYS if you 
have used wildcards in the file specifica- 
tion 


instructs the system to initiate the com- 
mand you issued but to pause and wait for 
you to mount the volume containing the 
files you want to process 


lists the differences between ASCII files (runs 
SRCCOM) 
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DUMP 


PRINT 
SET 


SHOW 


TYPE 


prints a file in octal words, octal bytes, ASCII 
characters, or Radix—50 characters (runs 
DUMP) 


prints files on a line printer (runs PIP) 


changes the default editor, terminal charac- 
teristics, the characteristics of physical de- 
vices, or the characteristics of parameters 


displays information about your RT—11 sys- 
tem 


displays the contents of a file on the terminal 
(runs PIP) 


References 


RT-—11 System Utilities Manual. Part 1 describes all utility 
programs available on RT—11. 


RT-11 System User’s Guide. DCL commands and their op- 
tions are listed alphabetically in chapter 4. 
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Writing a Program 
Source Code and Machine Code 
The Program Development Cycle 
Creating the Source File 
Creating the Object File 
Assembly Language 
Complied Language 
Interpreted Language 
Creating the Load Module 
Object Libraries 
Running the Program 
Detecting Errors 
Command Line Errors 
Compilation or Assembly Errors 
Link Errors 
Run-time Errors 
Interpretation Errors 
Increasing Program Development Efficiency 
COMPILE: Combining Several Source Files 
in an Object File 
EXECUTE: Compiling, Linking, and Running 
with One Command 
Program Overlays 
Summary 
References 
Solutions to Practices 


Developing 
Programs 


As an RT-11 user, you will probably want to solve prob- 
lems by running applications programs. If you are a pro- 
grammer, you will write these programs yourself in one of 
the programming languages supported by RT—11. The pro- 
cess of turning a list of source code instructions (in FOR- 
TRAN IV for example) into an error-free working program, 
is called the program development cycle. 

This chapter describes the steps of the program devel- 
opment cycle: creating a source file, compiling or assem- 
bling the program, linking object modules to form a com- 
plete program, and executing the program. 

You will learn to use the appropriate keyboard com- 
mands and utilities to assemble or compile the program, 
link the program, and run the program for a source file in 
MACRO-11 or FORTRAN IV. You will also learn to iden- 
tify situations in which you might use program overlays, 
ODT (the on-line debugging technique), and the librarian 
utility. 

a FN Et 5 
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Writing a Program 


You have used the system utility programs to perform a wide 
range of tasks. To solve problems which are specific to your 
own applications, you may need to write your own pro- 
grams. RT—11 provides software to help you to do this. 


Source Code and Machine Code 


Since computers can only understand machine language, 
programs provided as part of RT—11, such as the utilities, 
are in machine code (binary) ready to load and run. How- 
ever, you do not write application programs in machine code 
but in source code with a programming language such as 
MACRO-11, FORTRAN IV, or BASIC-11. 


perenne me ew am. enn et ey i bmi asm mt en seem ane cee ee 9 


A Pape task for fhe MACRO 4 STOatamiiien isa s : 
adding the contents of one location in memory to an- 

other. The source code statement which adds the eal 
contents of Register 1 to Register 0 te resister isa Spe. ee 
| pe BBL word | in memory) isi eS ees 


le : tT The equivalent binary machine code for this state- se : | i 
ment is: a eS, ae 


/¢110000001000000 Boe ee ee 


To translate the source code into machine code you will 
use utility programs provided by the operating system. 


The Program Development Cycle 


To develop a program you: 


1. Use your text editor and a programming language to 
create a source file. 
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Figure 12. 
The Program Development Cycle 
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LANGUAGE 
PROCESSOR 


LINKER 


RUN 
PROGRAM 


KEY TO SYMBOLS 


FILES THAT YOU 
= WILL CREATE OR 
REFERENCE 
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2. Use the appropriate language processor to create an 
object file which will contain an intermediate form of 
machine code. 


3. Link one or more object files to make a complete 
working program. The output from the link operation 
is called a load module. 


4. Run the program. 


The program development cycle is illustrated in figure 
12. We will now look at each step in detail, and by doing 
the practices you will be able to create a working program 
from a source file which is provided on your system vol- 


ume. 


Creating the Source File 


The source file is the text file which contains the source 
code of your program. Source files are created using a text 
editor, such as KED. The file type will usually indicate the 
language in which the program has been written. For ex- 
ample, PROG.FOR is a FORTRAN IV source file; PROG.MAC 
is a MACRO-—11 source file. A complete list of such file types 
is given in table 13. 


Practice Use a text editor to create a source file called US1001.MAC. 
7—1 Type the following text into the file: 


-PSECT 
«MCALL 
-ASCIZ 
»ASCIZ 


- EVEN 


CLR 
.PRINT 
JSR 
ASH 
JSR 
LEXIT 


US1001 
-TTYOUT,.-EXIT,.PRINT,.TTYIN 
/TYPE A NUMBER/ 
/NON-NUMERIC/ 


R1 ; R1 WILL CONTAIN THE NUMBER INPUT 

#ASK 

PC,INPUT ; INPUT A NUMBER INTO R1 

#1,R1 3 SHIFT 1 POSITION LEFT IE MULTIPLY BY 2 
PC,OUTPUT ; PRINT THE NUMBER IN R1 
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5 READ A NUMBER INTO R1 


INPUT: -TTYIN 
CMPB 
BEG 
MUL 
SUB 
CMPB 
BLT 
TSTB 
BLT 
ADD 
BR 
-TTYIN 
RTS 


RO 
#15,R0 
MULTI 
#10.,R1 
#'0,R0 
#9.,R0 
ERROR 
RO 
ERROR 
RO,R1 
INPUT 
RO 

PC 


3; OUTPUT A NUMBER FROM R1 


OUTPUT: CLR 
CLR 

LOOP: DIV 
MOV 
MOV 
CLR 
INC 
TST 
BNE 
MOV 
ADD 
« TTYOUT 
DEC 
TST 
BNE 
RTS 


RO 

Re 
#10.,R0 
R1,-CSP) 
RO,R1 

RO 

R2 

R1 

LOOP 
CSP)+,R0 
#'0,R0 
RO 

R2 

Re 


PC 


; ERROR IF NON-NUMERIC DATA 


ERROR: «PRINT 

ERLOOP: .TTYIN 
CMPB 
BNE 
-EXIT 
»END 


#ERMSG 

RO 

#12,R0 3 
ERLOOP 


START 


INPUT A CHARACTER TO RO 

TEST IF IT’S A (CR) 

END OF NUMBER IF IT IS 

MULTIPLY NUMBER BY 10 FOR NEXT DIGIT 
CONVERT NEW CHARACTER FROM ASCII 
ERROR IF NEW DIGIT IS GREATER THAN 9 


«.. QR LESS THAN ZERO 
ADD NEW DIGIT TO NUMBER SQ FAR 


THEN GO BACK TO READ NEXT CHARACTER 
GET (LF) 


CLEAR HIGH ORDER WORD FOR DIVIDE 


> WILL CONTAIN THE CHARACTER COUNT 


DIVIDE BY 10 CREMAINDER IN R1) 
PUSH LEAST SIGNIF. DIGIT ON THE STACK 
SET UP REMAINDER OF NUMBER 

FOR NEXT DIVIDE 
ADD 1 TO CHARACTER COUNT 
CHECK IF ANY MORE CHARACTERS 
IF THERE ARE, GO BACK FOR THE NEXT 
PRINT, GET 1ST CMOST SIGNIF.) DIGIT 
OFF THE STACK AND CONVERT TQ ASCII 
OUTPUT A CHARACTER 


; DECREMENT CHARACTER COUNT 
; TEST FOR MORE CHARACTERS TO DISPLAY 


BACK IF MORE 


IF NON-NUMERIC, PRINT ERROR MESSAGE 
READ NEXT CHARACTER 
TEST IF (LF) 


AND STOP. 


US1001.MAC contains the source code for a program writ- 
ten in MACRO-11. We will use this program later in the 

chapter to work through the steps of the program develop- 
ment cycle. 
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Table 13. 


Default File Types 


File Type 
.ANS 


. .BAC 


.BAD 


.BAK 
.BAS 
.BAT 
.BLD 


.BUP 
.CND 


.COM 


CTL 
CTT 
.DAT 
.DBL 
.DDF 
.DEV 
.DIF 
.DIR 
.DMP 
.DSK 
.FOR 
.LDA 
.LOG 
.LST 
.MAC 
.MAP 
.MLB 
.MON 
.OBJ 


.REL 


File Represented 


SYSGEN answer file 
Compiled BASIC program 


Files with unreadable or “bad” blocks; you can assign this 
file type to defective areas on a device. The .BAD file type 
makes the file permanent in that area, preventing other files 
from using it. 


Backup file created by the text editor 
BASIC source file (BASIC input) 
BATCH command file 


Command file to execute SYSGEN monitor (.MON) and de- 
vice handler (.DEV) build files 


Backup utility program output file 
SYSGEN conditional file 


KMON indirect command file, IND indirect control file, or SIPP 
command file 


BATCH control file generated by BATCH compiler 
BATCH internal temporary file 

BASIC, FORTRAN, or IND data file 

DIBOL source file 

DIBOL data file 

SYSGEN device handler build file 

BINCOM or SRCCOM differences file 

Directory listing file 

DUMP output file 

Logical disk file (for use with LD handler) 

FORTRAN IV source file (FORTRAN input) 

Absolute binary (load image) file (optional linker output) 
BATCH log file 

Listing file (MACRO, FORTRAN, LIBR, or DIBOL output) 
MACRO source file (LIBR, MACRO or SRCCOM input) 
Map file (linker output) 

MACRO library output file 

SYSGEN monitor build file 


Relocatable binary file (MACRO or FORTRAN output, linker 
input, LIBR input and output) 


Foreground job relocatable image (linker output, default for 
monitor FRUN and SRUN commands) 
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Table 13. Continued 


File Type File Represented 


SAV Memory image (default for R, RUN, SAVE, and GET key- 
board monitor commands; default for linker output) 

SLP SLP command file 

.SML System MACRO library 

.SOU Temporary source file generated by BATCH 

STB Symbol table file containing the symbols in object format 
produced during link 

SYG Monitor and handler files resulting from system generation 

SYS Monitor files and handlers 

.TBL Monitor device table section created during SYSGEN 

.TMP ERROUT temporary file 

TXT Text file 

.WRK Temporary work file 


Creating the Object File 


The first step in translating a source file into machine code 
is to produce an object file. This is done by special utility 
programs called language processors, and each program- 
ming language has its own language processor. 

The object file contains your program in object code, 
an intermediate code between source code and machine 
code. Each symbolic instruction is replaced by one or more 
machine instructions. References to memory locations, for 
example, names of variables, are replaced by addresses rel- 

ative to the start of the program or data section. This means 
that the assignment of absolute addresses in memory is de- 
ferred until the program is linked. 

Most programs contain references to code or data which 
is not contained within the source file. For example, all 
FORTRAN IV programs must include code from the FOR- 
TRAN IV object time system (OTS) to perform functions such 
as opening and closing files. The language processor does 
not resolve such references; this is not done until the pro- 
gram is linked. 
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Unless you specify otherwise, the object file created has 
the same file name as the source file and has the file type 
OBJ. For example, the object file produced from a FOR- 
TRAN IV source file PROG.FOR would be PROG.OBJ. 

The type of language processor used depends on the 
type of programming language you selected. As we men- 
tioned earlier, programming languages can generally be di- 
vided into three groups: assembly language, compiled lan- 
guage, and interpreted language. 


Assembly Language 


Practice 


7-2 


In assembly language programs, each line of source code is 
equivalent to one line of machine code, as you saw in the 
ADD instruction example. The RT—11 assembly language 
is MACRO-11. 

The language processor which translates an assembly 
language program into object code is called an assembler. 
The MACRO-11 assembler is called MACRO, and is in- 
voked by the command: 


MACRO FILENAME.TYP 
where FILENAME.TYP is the name of the source file. 


a 
4 
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EXAMPLE 


+MACRO PROG. MACETURN) 


: - tf your source file, like this one, aie the default file 
type MAC, then you | can 1 omit the file eyRS from the : 
: esbeaication | Aes Pa ea a 
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US1001.MAC contains the MACRO-—11 source code for a 
program which performs a simple calculation. 
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Use the MACRO-—11 assembler to produce an object 
file for this program. Since it has the default file type 
of .MAC, you do not have to specify the file type. 


Use the DIRECTORY command to show all the files 
which have the name US1001, regardless of their file 
type. Two files should appear: 


US1001.MAC—the source file 
US1001.OBJ—the object file 


Compiled Language 


RT-—11 supports a number of compiled languages, of which 
the best known is FORTRAN IV. In FORTRAN, each line 
of source code produces more than one line of machine code, 
and the language processor used is called a compiler. The 
object module produced by the compiler contains object 
code similar to that produced by the MACRO-—11 assem- 
bler. 

Assuming that you have the FORTRAN IV language 
processing program on your system, the command to com- 
pile your FORTRAN IV program is: 


FORTRAN FILENAME.TYP 


where FILENAME.TYP is the name of the FORTRAN IV 
source file. 


- EXAMPLE 


Tf your source file i is called PROG2. FOR, the com-- 
mand is: 


Se i iain i aaa ana inet hE 


FORTRAN PROG2. FORETURN) eee oe 
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The file type can be omitted if the default type is used. The 
default for FORTRAN IV source files is FOR. 
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To find out whether the FORTRAN IV compiler is available 
on your system, use the DIRECTORY command to look for 
the file FORTRA.SAV on your system volume. (On some 


systems, FORTRAN IV may be contained on a separate vol- 
ume. If this is the case, you should ask your system man- 
ager how to use FORTRAN IV on your system.) 


Compilers for other languages, such as COBOL-—11, are 
used in a similar way. 


interpreted Language 


Programs written in interpreted languages, such as BASIC— 
11, do not have the same development cycle as languages 
such as MACRO-11 and FORTRAN IV. All program devel- 
opment and execution takes place within an interactive 
program called an interpreter. No object code is produced, 
because the interpreter translates the source code directly 
into machine code and executes it a line at a time. 

BASIC—11, FORTRAN IV, and COBOL-11 are all high- 
level languages, that is, programming languages in which 
the language processor generates more than one line of ma- 
chine code from each line of source code. 


Creating the Load Module 


The object file cannot itself be executed, because object code 
is designed to enable separately compiled program units to 
be combined and executed as a single program. The file 
containing this complete program is called the load mod- 
ule. 

The load module is produced by a special utility pro- 
gram called the linker, invoked by the keyboard command 


Practice 
7—4 
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LINK. In the simplest instance—when the program con- 
sists of one source file and hence one object file—the com- 
mand to link the program is: 


LINK FILENAME.TYP 


where FILENAME.TYP is the name of the object file. 


EXAMPLE 


If the object code is in a file called EXAMP.OBJ, the 
command is: 


»LINK EX AMP RETURN) 


Notice that the file type can only be omitted if it is 
OBJ, the default for object files. 


Unless you specify otherwise, the load module which 
you create takes the file name from the object file and has 
a file type of SAV. For example, if the object file is called 
PROG2.OBJ, then the linker will produce a file called 
PROG2.SAV. 


Use the LINK utility to create the load module for the 
MACRO-11 program you assembled in practice 7-2. 
The object file is named US1001.OBJ. 


Use the DIRECTORY command to list all the files with 
a file name of US1001. You should now have three 
files: 


US1001.MAC—the source file (source code) 
US1001.OBJ—the object file (object code) 
US1001.SAV—the load module (machine-code) 
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Object Libraries 


It is possible to write a program as a collection of units, or 
subroutines, which can be compiled or assembled individ- 
ually. The linker can combine all the separate object files 
into a single load module. By breaking down programming 
instructions into units, you may find that some tasks, such 
as reading data from a file, are common to a number of pro- 
grams. Such commonly used subroutines can be made ac- 
cessible to other programs and users by storing the object 
code in a special file called an object library. 

Object libraries are created and maintained by the li- 
brarian utility program, LIBR. By giving the appropriate 
command to the linker, you can include the library subrou- 
tines you need into your program. Some object libraries are 
included with the system, for example the default system 
subroutine library SYSLIB.OBJ. 


Running the Program 


The load module produced by the linker is now in execut- 
able format (machine code), ready to load and run. The 
command generally used to run a program is: 


RUN FILENAME.TYP 


If you omit the file type, .SAV is assumed. 


preempt seer emery erereserenen nrenerain remeron eenintevtr mse eer epeenernan gti omer an pie eceemei eessn me tonne obec 


: ae EXAMPLE 


RUN HE Lower 


will tell the e system { to run the HELLO. SAV } ‘program. 


Seng ane and ce aias ae ena 
ye 3 : 
: Be 


IC Sasboiianioi inde Slated 


As mentioned earlier, you can also run programs by 
typing simply the program name. 


Practice 
7—5 


Chapter 7 Developing Programs 125 


EXAMPLE 


If you type: 


» HELL Ocreturn) 


CCL (Concise Command Language) looks for a file 
| called HELLO.SAV and, providing it is in executable 
: format, runs the program. 


Bervim aucnicinnniicin mil said aciaare i 9 nes Abedin ate sa een iecSsONC barnes eA RAMONE ASIEN Ota AAR Tne RONDE Sb iba Taine aphiihae Fintan banat RAB ARNO ana ae De 


The sample program, US1001, used in previous exercises is 
a MACRO-11 program for performing some simple arithme- 
tic. When you run it, it prompts you for a number, multi- 
plies the number by two, and displays the result. 


Use the RUN command to execute US1001. When it asks for 
a number, type any number between 1 and 9999, and the 
result will be displayed. 


Detecting Errors 


In the exercises you have done so far, each step should have 
produced the expected result, and the program should have 
run correctly the first time. When you develop and run a 
program for the first time this seldom happens. Although 
this book does not teach you how to correct programming 
errors, the information given in the following sections will 
help you recognize some of the common problems that can 
occur during program development. 


Command Line Errors 


If you make a mistake in the command line, the utility will 
not be able to produce the correct results. In this case, check 
all the details, including the file name. 
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Compilation or Assembly Errors 


Link Errors 


Run-time Errors 


The language processor checks the source code for syntax 
errors, such as unmatched parentheses on a line or branches 
to undefined labels. If it finds any, it displays a warning 
message. In this case, it is a good idea to run the language 
processor again with the /LIST option to request a listing 
showing the lines in which the errors have occurred. When 
you have identified the errors, use a text editor to correct 
the source code, and then try the compilation or assembly 
again. 


The linker searches the libraries which you specify and the 
default system object library, SYSLIB.OBJ, for external ref- 
erences in your program. If there are any unresolved refer- 
ences, a warning is given and the load module may not be 
produced. The error is usually the omission of an object file 
or library name in the command line. The problem may also 
occur if, for example, a subroutine name is misspelled in 
the source code. In this case, you will need to correct the 
source file and recompile the program, then link the sub- 
routines again. 


A program which has been compiled and linked success- 
fully may still not give the expected results when it is run. 
One of three situations may occur. 


1. The program may appear to run and complete cor- 
rectly, but the results are incorrect. 


2. The program may crash, giving a message indicating 
the cause of the problem. Sometimes this may also 
cause the operating system to crash. In this case, you 
will have to reboot RT—11 before you can continue. 
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3. There is no response from the program after a few 
minutes. This is usually caused by a loop in the pro- 
gram. To abort the program, press (ctrvc) twice. 


Such errors are usually caused by logic errors in the 
source code. The process of finding and correcting these 
errors, or “‘bugs,”’ is called debugging the program. Some- 
times, it is easy to identify the problem by examining a 
listing of the source code. Another useful technique is to 
add lines of source code which display the contents of im- 
portant variables at points before the program fails, and run 
the program again. 

MACRO-11 programmers can make use of a utility 
called the on-line debugging technique (ODT) to run their 
programs. This enables you to stop the program at impor- 
tant points and to look at the contents of memory loca- 
tions. Once you have found the error, make the necessary 
corrections to the source code using a text editor. You then 
have to compile, link, and run the program again. Figure 
13 shows the program development cycle and indicates the 
points at which you may have to correct and rerun the pro- 
gram. 


Interpretation Errors 


The correction cycle is different when you use an inter- 
preted programming language. An interpreter examines each 
program language statement, interprets it, and executes it 
before going on to the next. If it discovers an error that pre- 
vents further processing, it prints on the terminal a mes- 
sage informing you of the error condition and stops. You 
correct the error so that execution can continue past that 
point, and then rerun the program. 
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Figure 13. 
Errors in the Program Development Cycle 
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Increasing Program Development 


Efficiency 


COMPILE: Combining Several Source Files 


in an Object File 


The COMPILE command calls up the appropriate language 
processor to assemble or compile several source files into a 
single object file. The file type of the input source file de- 
termines the language processor that is called. 
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EXAMPLE 
.COMPILE PROG. MAC«reTuRN) 


tells the MACRO-—11 assembler to produce an object 
file from the MACRO-—11 source language statements 
in PROG.MAC. 
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To compile (or assemble) multiple source files into a 
single object file, separate the files by plus (+) signs in the 
command line. Unless you specify a file name, the system 
creates an object file with the same name as the first input 
file and gives it an .OBJ file type. You can combine up to 
six files for a compilation producing a single object file. 


EXECUTE: Compiling, Linking, and Running 
with One Command 


Like COMPILE, the EXECUTE command instructs a lan- 
guage processor to assemble or compile the source file you 
specify to produce an object file. It then calls up the linker 
and runs the resulting load module. 
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' EXAMPLE © = ees 
- LEXECUTE. MYPROG. FOR«return) 
! generates two files front ‘this FORTRAN Iv source ne: 


MYPROG. OBJ—the object file 
MYPROG.SAV—the load module 


Program Overlays 


In general, the more source code a program contains, the 
more space it will occupy in memory. On systems without 
the extended memory option, 28K words of memory is 
available to a program, although some of this is used by the 
resident portion of RT—11. On systems which have the ex- 
tended memory and memory management options, you can 
write programs that use up to 32K words of memory. If you 
want to write a program that is too large to fit the memory 
available to your system, you must use an overlay struc- 
ture. 

In an overlay structure, you write the program in parts 
so that it can be executed in parts. Some of these parts, or 
segments, are allowed to share memory with other seg- 
ments, thus reducing the overall memory requirements of 
the program. One segment of the program is called the root 
segment and must remain in memory at all times. The root 
segment contains the information needed by other seg- 
ments of the program, called overlay segments. 

A program which is to be overlaid must be written in 
modular form. That is, it should have a main program unit 
which calls a number of subroutines. When you load a pro- 
gram linked with overlays, the subroutines which are to be 
overlaid stay on the disk. When one of the subroutines is 
called, it is loaded to a fixed address within the program 
space in memory. If another subroutine is then referenced, 
it is loaded to the same address, overlaying the code for the 
previous subroutine. This reduces the amount of memory 
needed to run the program, because not all of the program 
is loaded at any one time. 
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EXAMPLE 


R LINK 

'Run the linker program 
FILE=FILE, SUBA/F/C 

'Build a .SAV with FILE, SUBA, 
'FORTRAN OTS library and 
SUB1/0:1/C 
'Put SUB1 into overlay 
'region 1 and continue | 
SUB2/0:1/C 

‘Put SUB2 into overlay 
‘region 1 and continue 
SUB3/0:2/C 

'Put SUB3 into overlay 
'region 2 and continue 
SUB4/0:2/C 

'Put SUB4 into overlay 
‘region 2 and end 


Summary 


PROGRAM DEVELOPMENT CYCLE 


li 


Create a source file (a file which contains your program writ- 
ten in assembly- or a high-level language) using a text editor 
Assemble or compile the source file into an object file (a file 
which contains an intermediate form of machine code) using 
a language processor 

Create the load module by linking one or more object files 
into a complete program 

Run the program 


COMMON ERRORS IN PROGRAM DEVELOPMENT 


Mistake in a command line 

Syntax error in the source code 

Omission of the name of an object file or library 
Incorrect subroutine name 

Error in the logic of the program 
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DCL COMMANDS USED IN PROGRAM DEVELOPMENT 


COMPILE _ calls up the appropriate language processor to as- 
semble or compile a source file into an object file 


EXECUTE _ instructs a language processor to assemble or com- 
pile a source file into an object file, calls up the 
linker, and runs the resulting load module 


RUN runs the load module (the program in machine 
code) produced by the linker 


References 


Introduction to RT—11. Chapters 8 through 11, outlines the 
program development cycle under RT—11. 


RT-11 System User’s Guide. See the COMPILE and EXE- 
CUTE commands in chapter 4. See also section 3.4 for a com- 
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Solutions to Practices 


The commands you should type are as follows. 


7-1. .EDIT/CREATE US1001.MAC 
then type in the source program. 


7-2. -MACRO US1001 
7-3. .DIR FORTRA.SAV 
7-4. .LINK US1001 


7-5. -RUN US1001 
then type a number between 1 and 9999. 
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Creating Files 
Of Commands 


As you work with RT—11, you may find yourself entering 
a large number of commands in order to complete some 
tasks. These may be commands to run programs or to or- 
ganize disk storage. Entering large numbers of commands 
repeatedly is time consuming, and you may make typing 
errors. Therefore, RT—11 provides two methods of storing 
commands for execution at a later time: indirect command 
files and indirect control files. 

This chapter shows you how to create and use indi- 
rect command files. To make use of indirect control files, 
however, you must master a more difficult set of instruc- 
tions. While we will suggest and illustrate the ways to use 
these instructions, we cannot hope to make you proficient 
in the remaining pages of this book. 
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Understanding Indirect Files 


When you type a keyboard command, the keyboard moni- 
tor processes it immediately or ‘‘directly.” If you place the 
same command in a file, the monitor can process it later or 
“indirectly” by opening the file and reading it. The file that 
contains the command is called an indirect file. Such files 
are useful for storing sequences of commands that you use 
repeatedly, especially when those sequences require much 
computer time, but little intervention from you. Examples 
of such jobs include: assembling multiple source files, 
compiling programs, making backup copies of disks, or 
transferring data from one device to another. 

RT-—11 supports the use of two types of indirect files, 
indirect command files and indirect control files. Indirect 
command files contain only monitor commands and any 
responses that those commands need. Indirect control files 
contain control instructions in addition to the commands 
and responses found in command files. You will need to 
put control instructions in your file whenever you wish to 
carry out a complex operation that requires periodic atten- 
tion from you or that makes decisions based on unpredict- 
able information. 


Indirect Command Files 


You create an indirect command file the same way that you 
create a text file, by calling up a text editor (such as KED), 
by naming the file, by supplying a file type, and by typing 
information into the file—in this case, the commands to be 
executed. 

You can use the EDIT/CREATE command to start a new 
file. The default file type for indirect command files is .COM. 
You type each command one to a line and in the sequence 
it will be executed. You should not type a period (the mon- 
itor prompt) before each command. Once you have entered 
the commands in your file, you can issue the EXIT com- 
mand to leave the editor and save the newly created file on 


a disk. 
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EXAMPLE 


To print the time and date and create backup copies 
of all FORTRAN IV source programs on the default 
storage device DK: you would type the following 
commands into a file: 


i oe tn aoa Rika cin sab atoms, Saat hcg 


DATE 
TIME | | 
COPY *.FOR *.BAK 


When you use wildcards in the file specification of 
certain commands, like DELETE, the system expects to get 
a response from you before carrying out the command on 
each file that fits the specification. If you use such com- 
mands in a file and do not include the responses, indirect 
file processing will stop. There are three things you can do 
if commands require a response: 


1. Use the /NOQUERY option with the command, for 
example: 


DELETE/NOQUERY MYFILE.* 


2. Work interactively with the terminal and supply the 
responses when needed. When this method is used, 
the process cannot run without you. You inform the 
system that you want to give the responses at the ter- 
minal by placing a special form of (ctruc) in the com- 
mand file, for example: 


INITIALIZE/NOQUERY/VOLUMEID DM1: 
“Cc 


(ctruc) is indicated by a circumflex (*) followed 
by the letter C. *C tells the system to take all 
other input lines from the console terminal. 
When you finish typing in a response, the indi- 
rect command file continues with the next com- 
mand line. 
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3. Supply the responses in the command file, for exam- 
ple: 


INITIALIZE/NOQUERY/VOLUMEID DM1: 
NEWDISK 
DATAPACK 


Using the /NOQUERY option prevents the need 
to respond Y[es] to the prompt normally dis- 
played after the INITIALIZE command. The vol- 
ume identification and owner name needed by 
the /VOLUMEID option is given in the second 
and third lines of the file. 


You cannot include responses that would destroy data in 
indirect command files. 


EXAMPLE : a on 
The following command file: : ete eed 


INITIALIZE 
DK: 
oy 


does not work because a yes or no response must 
come from the terminal, not a command file. 


You use the /NOQUERY option to prevent the prob- 
lem. 


Adding Comments to Indirect Command 
Files 


You may include comments in indirect command files to 
help you document your work. These comments do not print 
on the console terminal when the indirect file executes. 
Begin each line of comment with an exclamation point (!). 
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The system ignores anything that it finds between the ex- 
clamation point and the end of the current line. 


Executing Indirect Command Files 


Once you have created an indirect command file, you may 
start its execution by typing an at sign (@) followed by the 
name of the indirect command file. 


EXAMPLE 


-@MAKE 


Susisctina sn mata dnattainernsennincseont aed 2 a 


The file type is assumed to be .COM by default. If you 
have used any other file type, you must specify it in the 
command. 


EXAMPLE 


The following indirect command file assembles and 
links a MACRO-—11 program called MYPROG and 
then displays on the terminal a directory of all files 
named MYPROG: 


pinning statisti 


' MAKE.COM 
! 

'This indirect command file assembles 
fand links a program called MYPROG. 
'The indirect command file is run by 


'typing 
! 


!@MAKE 
! : 
MACRO/LIST/CROSSREFERENCE MYPROG = 
Me . 'Do. the assembly<jece i 
| LINK/MAP MYPROG = !Link the object | 
_ DIR MYPROG.* 'See the files alee 
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Practice Write an indirect command file which displays the current 
8—1 date and time, shows the RT—11 configuration, and lists a 


directory of all .MAC source files on DK: in alphabetical se- 
quence. 


Indirect Control Files 


Indirect control files give you more flexibility and control 
than indirect command files. With indirect control files you 
can use monitor commands, and you can also use special 
commands called IND directives to control system execu- 
tion. IND directives are like keyboard commands but are 
executed by IND, the indirect control file processing util- 
ity, rather than the keyboard monitor. 

Each IND directive starts with a period (.). Keyboard 
commands have no preceding characters when used in a 
control file. IND processes all commands which start with 
a period (.) and passes all other commands to the keyboard 
monitor (KMON). Control files can be used to execute key- 
board commands, access files, and perform logical tests to 
control the flow of execution. Because indirect control files 
have these features, they resemble programs written in a 
high-level language. IND directives can be studied as if they 
were the statements of a programming language. 


Creating an Indirect Control File 


An indirect control file contains one or more lines of direc- 
tives or keyboard commands. Each line can contain up to 
three elements: a label, IND directives or keyboard com- 
mands, and a comment. 

Labels are used to mark specific locations in a pro- 
gram. IND directives and keyboard commands control the 
execution of your program and perform specific opera- 
tions. Comments allow you to document your control pro- 
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gram and also to display information. These elements must 
be arranged in the following format: 


.LABEL: IND DIRECTIVE ‘external comment 
or or 
KEYBOARD COMMAND _ .;internal comment 


Labels 


A label assigns a name to a line so that the line can be ref- 
erenced. Labels can have up to six alphanumeric or dollar 
sign ($) characters and must start with a period (.) and end 
with a colon (:). 


EXAMPLE 


~START: 


Only one label can appear on each line and it must be 
placed at the beginning of a line. A label can share a line 
with directives, keyboard commands, or comments or oc- 
cupy a line by itself. 

Labels allow IND to find a specific sequence of com- 
mands in a file. When your control file instructs IND to find 
a label, IND determines whether or not the label is a direct 
access label. A direct access label is a label placed on a line 
by itself; you can define twenty such labels within an in- 
direct control file. (IND maintains a table of up to twenty 
direct access lables.) If you define more than twenty labels, 
the new labels replace the old labels beginning with the first 
one on the table. 

When a label is referenced, IND first checks the direct 
access table. If it is a direct access label, IND goes directly 
to the label in the file. If it is not, IND searches the file from 
the cursor to the end, then starts from the beginning of the 
file and searches to the cursor. 


IND Directives and Keyboard Commands 


A control line may contain IND directives and monitor 
commands (either DCL or CCL commands). Each complete 
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command string must fit on one line. Directives and mon- 
itor commands can be used together, on the same line or 
on separate lines. You separate directives from monitor 
commands with a space or a tab. Some directives can also 
be used on the same line with other directives. 


IND directives allow you to do the following: 
Define labels: 


.LOOP: a name preceded by a period (.) 
and followed by a colon (:), in 
this case .LOOP:, can be as- 
signed to a location in your 
control file, to give you ready 
access to that location 


Define and assign values to logical, numeric, and 
string variables. These variables can then be used in 
place of values in IND directive and monitor com- 
mand strings: 


.SETS LINE “ABC” sets the string variable LINE equal 
to ABC 

.SETN NUM 10 sets the numeric variable NUM 
equal to 10 


Create and access data files: 


.OPENA #0 COMMND _ opens a file so that records can be 
written to it. The default type is 


DAT 

-DATA #0 “ABCD” writes the string ABCD to the file 
COMMND 

CLOSE #0 closes the file COMMND 


Control the logical flow of processes within a control 
file: 


.GOTO LOOP go to the line that has the label 
LOOP 
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e Perform logical tests: 


IF LINE=“‘ABC” .GOTO LOOP 
if the string variable LINE is equal 
to the literal string ““ABC”’ then 
go to the line which has the la- 
bel LOOP 


e Enable or disable operating modes: 


-ENABLE ESCAPE when ESCAPE is enabled, IND 
recognizes (6sc) as a valid re- 
sponse to a question (.ASK, 
.ASKN, .ASKS) 


ENABLE TIMEOUT used with questions (.ASKS, 
.ASKN, .ASK) so that, if a re- 
sponse is not given in a defined 
period of time, the execution of 
the control file is aborted. Time- 
out is available only on systems 
with timer support and a clock 


e Increase or decrease the value of a numeric symbol: 


INC NUM adds 1 to the numeric variable 
NUM 


e Perform operations which depend on time (if you 
have timer support): 


DELAY 10S delays the execution of the con- 
trol file by 10 seconds 


-ASKS[:::20S] NAME WHAT IS YOUR NAME 
causes the execution of the con- 
trol file to be aborted if a re- 
sponse to the question is not 
given in 20 seconds. The format, 
nnU (where nn is a number and 
U is a unit of time), is used to 
specify the amount of time to 
wait for a response 


144 


Working with RT—11 


Internal and External Comments 


Comments can be used for documentation within your file. 
They can be either internal or external and can be up to 
132 characters long—including the period, semicolon, car- 
riage return, and linefeed characters. 

Internal comments allow you to document your con- 
trol file. The comments are not displayed during program 
execution but are used to explain the internal operations of 
the control file. Internal comments are defined by a period 
(.) followed by a semicolon (;). 


EXAMPLE 


.3 This is an internal comment 


They can be used on lines by themselves, on lines with 
a label, or with a number of directives. You must not use a 
comment on the same line as a keyboard command, be- 
cause the keyboard monitor will interpret the comment as 
an invalid command. 

External comments are displayed at the console dur- 
ing program execution to give you information when the 
control file is run. External comments are defined by a 
semicolon (;). 


OS tt cet es OE at et OUR a El kane 


EXAMPLE 


;This is an external comment 


You can use external comments on lines by them- 
selves, on lines with labels, and with logical test direc- 
tives. You cannot use them with program control (branch- 
ing) directives because the branch is performed before the 
comment is processed. In general, do not use external com- 
ments with any directive which displays or contains text 
(for example .ASK). As a general rule, it is better to put 
comments on a line by themselves. 


Chapter8 Creating Files Of Commands 145 


The following indirect control file does the same job 
as the indirect command file that we looked at earlier in 
the chapter, but allows you to specify an input file name at 
run-time. 


EXAMPLE 


i 
| 
;get input source file name 
ASKS [1:6] FILE ENTER SOURCE FILE NAME | 
sadd file extension 
.SETS FILNAM=FILE+".MAC" | 
sassemble file here | 
MACRO/LIST/CROSSREFERENCE “’FILNAM? | | 
snow link the file ! 
Poet SE INK: PILE? 
;and take a directory | 
DIR ’FILE’ 
; 


iy me svn aC oink ES RGR eS Rh RNs Pu tna SRN Ress iti aid OA DLS ana BW Bs ad lonaaRienaeecuelMRt RNasin i BiCad Ssh ait 


Executing Indirect Control Files 


You can execute indirect control files either from keyboard 
monitor level or from within another indirect control file 
(discussed later in the chapter). 

To execute an indirect control file from keyboard 
monitor level, you must call IND. 


EXAMPLE 


~-.R- TEND Return) 
Cee : 


Rene al OE oUt ll RON ARIE asa isa Sane Na Neti He Ean ana rel Rae SE SSI SiC BE AB BN OA NE BARS aI IAS BS xR AERA AEC RR EN aS aI HOO 


The Command String Interpreter (CSI) prints an aster- 
isk at the left margin of the terminal and waits for you to 
enter the specification of an indirect control file. 

To abort execution of a control file, you press (ctruc) once 
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if the system is waiting for you to type in data, otherwise 
you press (ctruc) twice. The syntax of the command string is: 


CONTROL-FILESPEC/OPTION [parameters] 


CONTROL-FILESPEC represents the control file you 
want to execute. The default file type is .COM. /OPTION is 
one or more of the options listed in table 14. Parameters is 
one or more values (up to nine) that you can pass to the 
control file. The brackets are not part of the command syn- 
tax; they indicate that the parameters are optional. You must 
separate each parameter you specify with a space. 

When SET KMON IND is in effect, you can use the 
following syntax to execute a control file: 


@CONTROL-FILESPEC/OPTION [parameters] 


IND Options 


IND options allow you to change the way IND processes and 
displays a control file. The four IND options (/D, /N, /Q, /T) 
are listed and explained in table 14. 


Passing Parameters 


When you give the specification for a control file, you can 
assign values to nine variables or parameters the system 
makes available. The parameters are named P1 through P9. 
Control instructions within a file refer to these parameters 
for data. The act of assigning values to these parameters is 
called passing parameters. Passing parameters allows you 


Table 14. 

IND Options 

Option Function 

/D Deletes the control file when IND has finished processing that 

/N Direc IND to ignore all keyboard commands in the control 

/Q Suppresses the display of keyboard commands and their 
results 


/T Displays each command line that has been processed 
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to predetermine the value of these variables when you be- 
gin execution of a control file. Parameter values can be 
names of other symbols, numeric values, or character strings. 


Nested Indirect Control Files 


You can call indirect control files from within an indirect 
control file. This process is called nesting control files, and 
is similar to the use of subroutines in programs. You can 
embed or nest up to three control files within a control file, 
for a total of four levels of control files. 

You use a command line with the following syntax to 
call a control file from within a control file: 


@CONTROL-FILESPEC/OPTION [parameters] 


CONTROL-FILESPEC names the file to which you want 
to branch. The system assumes that the file type is .COM. 
/OPTION is one or more of the options listed in table 14. 
Parameters is one or more values (up to nine) that you want 
to pass to the control file. You cannot include internal or 
external comments in this command line. 

The .ENABLE GLOBAL directive allows symbols to 
retain their values on every level of a control file. Without 
this directive, IND automatically masks all symbols de- 
fined by the previous level as it goes from one nested file 
to another; it recognizes only the symbols defined in the 
current level of a nested file. When control returns to a pre- 
vious level, the symbols defined there become available 
again and the symbols from the lower levels are lost. 


Executing Indirect Command Files from Control Files 


To call an indirect command file from within an indirect 
control file, you type a dollar sign and an at sign ($@) be- 
fore the name of the indirect command file you wish to ac- 
cess. When you pass control to an indirect command file, 
the keyboard monitor processes and executes the file. Con- 
trol then returns to the control file from which the indirect 
command file was called. The format of the command that 
calls up an indirect command file is: 


$@FILESPEC 
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The keyboard monitor assumes that any file you specify has 
the file type .COM. 


: “EXAMPLE 


The following conan line dalle up the indirect eee 
command file DYOUT. COM: ee ee ae 


Seen cae ata mena: pereacnet 


= = S@DYOUTaeTNY ae Los < ue as COE is ie a | 


iia mena Aon a ely NAHE aR RAN SRR AA BNA iS i i EA EERE A ARR REE ASR RMA OAR ARIE DE NORA AE EIR IRE i AARNE AEE SAAN 


: 
: 
io 
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IND Directive Summary and Operating 
Modes 


The IND directives are listed in table 15 by category. Use 
these directives in your control files to direct execution. 
Table 16 lists the operating modes you can use with .EN- 
ABLE and .DISABLE directives. The entry in the scope col- 
umn refers to whether the operating mode automatically 
returns to its default setting or remains at its current set- 
ting when control passes to a nested control file. Local op- 
erating modes return to their default settings; global oper- 
ating modes keep their current settings. 


Table 15. 
IND Directive Summary 


Directive Function 


Label Definition 


-LABEL: . Assigns a name to a line in the control file so 
that the line can be referenced 


Symbol Definition 


ASK Prints a prompt and uses the response to define 
a logical symbol and to assign the symbol a log- 
ical (true or false) value 


.ASKN Prints a prompt and uses the response to define 
a numeric symbol and to assign it a numeric 
value 

ASKS Prints a prompt and uses the response to define 


a string symbol and to assign it a string value 
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Table 15. Continued 


Directive 


.DUMP 
ERASE 


.PARSE 
.SETD or .SETO 


SETL 
.SETN 
SETS 


-SETT or .SETF 


TEST 
.TESTDEVICE 
.TESTFILE 


VOL 


File Access 
.CHAIN 


.CLOSE 
DATA 


OPEN 


.OPENA 


Function 


Displays local, global, and special symbol defi- 
nitions 
Deletes local or global symbols from the symbol 
tables 


Breaks a string into substrings 


Redefines a numeric symbol to decimal (.SETD) 
or octal (.SETO) radix 


Defines a logical symbol and assigns it a logical 
value 


Defines a numeric symbol and assigns it a nu- 
meric value 


Defines a string symbol and assigns it a string 
value 


Defines a logical symbol or redefines bits within 
a numeric symbol and assigns the symbol or bits 
a true or false value 


Tests attributes of a symbol or sting and stores 
the results in special symbols 


Tests a specified device and stores the device 
attributes in the special symbol (EXSTRI) 


Determines if a file exists and stores the results 
in the special symbols (FILSPC) and (FILERR) 


Assigns a volume ID to a string symbol 


Closes the current control file, opens another file, 
and resumes execution 


Closes an output data file 


Specifies a single line of data to be sent to an 
output data file 


Creates an output data file. If the file you specify 
with .OPEN already exists, OPEN creates a new 
file and will delete the existing file if you subse- 
quently use the .CLOSE directive. Use the 
.OPEN directive only when you wish to write to 
a file 


Opens an existing file and adds data to it. If the 
file you specify does not exist, .OPENA creates 
a new file. Use this directive only when you wish 
to write to a file 
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Table 15. Continued 


Directive 


OPENR 


.PURGE 


.READ 


Logical Control 
.BEGIN 

.END 

.EXIT 


-GOSUB 
.GOTO 
-ONERR 


.RETURN 


STOP 


Logical Tests 
IF 


IFDF or .JFNDF 
.IFENABLED or 
.FDISABLED 
.IFLOA or .IFNLOA 


FT or .IFF 


Execution Control 
.DELAY 


Function 


Opens an existing file for use with the .READ 
directive. Use this directive only when you wish 
to read from a file 


Discards or closes an output file without making 
any changes to the file 


Reads the next record from a file into a string 
variable. The file must have been previously 
opened with .OPENR 


Marks the beginning of a begin-end block 
Marks the end of a begin-end block 


Terminates processing of either the current con- 
trol file or a begin-end block, and returns contro! 
to the previous level; can also assign a value to 
the numeric symbol (EXSTAT) 


Branches to a subroutine within the control file 
Branches to another location in the control file 


On detecting an error, branches to another !o- 
cation in the control file 


Returns control from a subroutine to the line im- 
mediately following that subroutine’s call 


Terminates control file processing 


Determines whether a symbol satisfies one of 
several possible conditions 


Determines whether a symbol is defined or not 
defined 


Determines whether an operating mode is en- 
abled or disabled 


Determines whether or not a device handler has 
been loaded 


Determines whether a logical symbol is true or 
false or tests specific bits in a numeric symbol 


Delays control file processing for a specified pe- 
riod of time 
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Table 15. Continued 
Directive Function 


Enable or Disable Operating Modes 


.DISABLE Disables the operating modes 

-ENABLE Enables the operating modes 

Increase or Decrease Numeric Symbols 

.DEC Subtracts one from the value of a numeric sym- 
bol 

INC Adds one to the value of a numeric symbol 

Table 16. 

Operating Modes 

Operating 

Mode Default Scope Function 

DATA Disabled Local When DATA is enabled, IND sends 


to an output file all lines that follow 
the .ENABLE DATA directive until a 
.DISABLE DATA or .CLOSE direc- 
tive is encountered 


DCL Enabled Local When DCL is disabled, IND sup- 
presses execution of keyboard 
commands in a control file 


DELETE Disabled Local When DELETE is enabled, control 
files are deleted after execution of 
the file has completed 


ESCAPE Disabled Global When ESCAPE is enabled, IND 
recognizes the escape character as 
a valid response to an .ASK, .ASKS, 
or .ASKN directive 


GLOBAL Disabled Global When GLOBAL is enabled, symbol 
names that begin with a dollar sign 
($) are recognized as global sym- 
bols; that is, these symbols are rec- 
ognized throughout all levels of 
control files 
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Table 16. Continued 


Operating 
Mode 


LOWERCASE 


Default 


Enabled 


Scope 


Global 


Function 


When LOWERCASE is enabled, 


MCR 


OCTAL 


PREFIX 


QUIET 


SUBSTITUTION 


SUFFIX 


TIMEOUT 


TRACE 


Enabled 


Enabled 


Enabled 


Disabled 


Enabled 


Enabled 


Disabled 


Disabled 


Local 


Global 


Global 


Local 


Giobal 


Global 


Global 


Local 


characters typed in response to an 
.ASKS directive are stored in the 
string symbol without automatic 
lowercase to uppercase conversion 


When MCR is disabled, IND sup- 
presses execution of keyboard 
commands in a control file 


When OCTAL is enabled, the de- 
fault radix of responses to .ASKN 
directives and of numeric symbol 
definitions is octal 


When PREFIX is disabled, IND 
suppresses printing of the asterisk 
(*) before all prompts that result from 
ASK, .ASKN, and .ASKS direc- 
tives, and the semicolon (;) in front 
of comments 


When QUIET is enabled, IND does 
not display keyboard command lines 


When SUBSTITUTION is enabled, 
IND replaces symbols with their as- 
signed values 


When SUFFIX is disabled, IND sup- 
presses printing of the question mark 
and [Y/N] notation at the end of an 
.ASK prompt, and suppresses range, 
default, timeout, and question type 
notations for all ASK directive 
prompts 

When TIMEOUT is enabled, IND 
recognizes the timeout parameter for 
ASK directives if your monitor in- 
cludes timer support 


When TRACE is enabled, IND dis- 


plays the command line processed 
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Sample Application 


Suppose you want to assemble a program, using the MA- 
CRO assembler; to link it, using the LINK program; and fi- 
nally to run it. You can either: 


¢ Type the keyboard commands at the console, or 
e Put the commands in an indirect command file, or 


¢ Put the commands, along with control instructions, 
in an indirect control file 


If you use the first method, you must type the com- 
mands each time you want to perform this operation. If you 
use an indirect command file, you run only the file, but the 
commands in it cannot be changed. You must use the same 
file names and carry out the same instructions each time 
you perform the operation. 

Using an indirect control file allows you to get infor- 
mation interactively, check that information, and select op- 
tions as the system carries out the keyboard commands in 
the control file. 

Before you use the MACRO keyboard command to solve 
the problem stated above, you must know: 


1. The file name and extension of each of the source 
files you want to assemble. You must have at least 
one file, and not more than six. 


2. Whether or not the files are on the source device. 


3. Whether or not an assembly listing is needed, and if 
so, the name of the listing device or file. 


4. Whether a cross-reference listing is needed, and if so, 
the name of the listing device or file. 


5. What defaults will be used if you omit any informa- 
tion. 


Figures 14, 15, 16, and 17 show a detailed flow diagram (in 
four parts) of the problem. 
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Figure 14. 
Control File Flow Diagram (1) 
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Figure 15. 
Control File Flow Diagram (2) 
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USE DEFAULT 
.MAC 
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? 
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‘CONTROL FILE , 
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24. 


ASK IF USER 
WANTS TO 
RUN PROGRAM 


25. 


46. 


PRINT ERROR 


NUMBER 26, 27, 28. 


BUILD RUN 
COMMAND 
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DATA FILE 


CHAINTO NEXT 
CONTROL FILE 


29. 


156 


Working with RT—11 


Figure 16. 
Control File Subroutine Flow Diagram 
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Diagram of Nested Control Files 
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RUNNER. 
COM 


OPEN 
DATA FILE 


66. 
READ 


COMMAND 
LINE 


67. 


CLOSE 
DATA FILE 


68. 


DO 
RUN FILENAME 
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Figure 18. Main Indirect Control File 
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(Continued) 


 OROOKIOKA KKK KAKKKKKKKEKK this 26 &@ Subroubire KKK KKK KKK KKK KKK KK AK KK 
S OOOOCOIOKOOOOGOK it assembles ur to 46 source files XKKKKKKKKKKKX 
9 KKKKKKKKKKSS wark of main conmtrol files variables are available ¥KXK* 


30 


eIF INCNT = 0 .GOTO ERRORI ' cannot assemble without direut ! 31 


/ASKS CeisOUTR IA OUT OUTFILE (tyre <RETS if defy<ESC> if mone)? 32 


9 

oy Seb outeut file mamey default 
+e Or money and start testing 

7 


*SETS OUT “/NOOBJECT" +) S$et for mone if ESCs 33 

ASETS OUT “/OBJECT? *+OUT oy Set outfile name 34 
? 

“ASKS C2e"Let"4 LST LIST FILE (ture <ESCPif money cRETSif LEI)? 35 


oy 
> get List file mames LF? or mone 
A] 

«IFT <ESCAPES .GOTO MACIL oF ro lists so mo x-ref either 36 
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eIFF ESCAPES «ASK [x FALSESI XR X-REF LIST (tyre RETeif mone)? 37 
eIFT XR LASKS Ci Les" CRLIST X-REF FILE (ture <RET> af LPS)? 38 


ey 
3 

eIFT XR .SETS CR = "/CROSS-REFERENCE* + CRLIST .% set for x-ref 39 
eY 


MACRO/LISTiI LST’ “OUT! “CR? “FILE? 40 
$ do the assembly with List 
+RETURN sy and return from subroutine 41 


MACKO “FILE? 43 
+ do the assembly without Listins 

+RETURN ey and return 44 
if the subroutine XKRKKKKKKKKKKK 


a 
o? 
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*ERROR S 


+ERRORD 3 


sERROR NUMBER “<FILERR: “ OCCURRED 46 
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~STOF 47 
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°) Brother error 
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oy id vou mean to 
od finish 7? 
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7) #YeESy SO Stor 


Figures 18 and 19 show sample control files that were 
written from the flow diagram. To learn how to use the IND 
directives and write control files, you should analyze and 
compare the information in the figures with that of the fol- 
lowing section. 
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Indirect Control Files 
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Analysis of an Indirect Control File 


Refer to the text discussions in this chapter and to the flow 
diagrams as you work through the following analysis of the 
indirect control file presented in figure 18. 


Line Directive Discussion 


1 -DISABLE SUFFIX Prevents display of suffixes. 
When asking for information, 
with .ASK, .ASKN, or .ASKS, 
we can specify default values, 
timeout periods, and numeri- 
cal ranges. These items of in- 
formation are shown in the 
display as display suffixes. 


2 -ENABLE ESCAPE Enables the use of (Esc) as an 
| operator response. (Esc) is used 
in the program to indicate that 
all source file names have 
been entered. 
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Directive 


ENABLE TIMEOUT 


ENABLE GLOBAL 


.SETN and .SETS 


label: 


.ASKS 


Discussion 


If a response to an .ASK, 
.ASKN, or .ASKS is not re- 
ceived in a given time, execu- 
tion will be aborted. 


Makes all symbols which start 
with a dollar sign ($) available 
to the entire control file, and 
to any control file which it 
may call (nested control file). 


Define or redefine a symbol 
and assign a value to it. In line 
3, for example, a numerical 
symbol is defined and as- 
signed an initial value of 0. It 
will be used to control the 
loop when we process up to 6 
input files. The string variable 
CR will be used later, either as 
null or to contain the /CROSS- 
REFERENCE option. In line 4 
it is set to null. 


Marks a specific line in the 
control program. Labels may 
be on the command line or on 
a separate line. In this case, if 
the operator presses (RETURN) by 
accident in line 8, if less than 
6 files have been processed in 
line 19, or if the operator does 
not press (esc) in line 6, the 
program goes back to the label, 
-LOOP:, in line 5. 


Displays text and expects a 
string response. In line six 
.ASKS is used to get the Ma- 
cro source file names. Because 
we enabled ESCAPE in line 2, 
an (ESC) response at line 6 is al- 
lowed and if typed sets a spe- 
cial symbol ESCAPE to true 
(1). This symbol can later be 
tested. 
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Line Directive 
7 FT 

8 IF 

9 label: 

10 .ASKS 


Discussion 


IF True—one of a number of 
logical tests. At line 7 it is 
testing the special symbol ES- 
CAPE to see if (ésc) was typed 
at line 6. If it was, the program 
immediately branches to the 
label .COMP at line 20. This 
works because ESCAPE was 
enabled in line 2. 


A more general logical test 
with the format: .IF symbol 
logical-operator expression 
There are 6 logical operators: 

EQ or = 

NE or <> 

GE or >= 

LE or <= 

GT or > 

LT or < 


In this program, we are check- 
ing to see if the user pressed 
(RETURN) by mistake. If (RETURN) 
has been pressed the program 
goes back to .LOOP:. 


-LOOP: marks the line where 
we get the source input file ex- 
tension. 


With the feature [::‘..MAC”’], 
allows us to supply a default 
value .MAC if (return) is typed. 


The general form of the op- 
tional parameters is 
[low:high:“‘def”’:time]. Low 
and high allow you to specify 
the character range. You can 
use values between 0 and 132 
decimal. These are the charac- 
ter codes of each character in 
the user’s response. ‘‘Def”’ al- 
lows you to specify a default 
character string. Time allows 
you to specify a timeout pe- 
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Line Directive Discussion 


riod in the form nnU where U 
is either T for ticks (1/10 sec- 
ond), S for seconds, M for 
minutes, or H for hours. Line 
49 shows the time parameter 
being used. Remember you 
must enable TIMEOUT (as was 
done in line 2) before time can 
be used. 


11 IFT Tests to make sure that (esc) 
was not typed. 


12 SETS Set String—assigns a value to 
a string symbol; here it makes 
one string from the input file 
name and extension. 


13 .TESTFILE Tests to see if a file is in the 
directory. In this example, it 
tests for the specified input 
file. The results of the test will 
be placed in a special symbol 
(FieRR) for later testing. 


14 JF Tests (FILERR). Success is indi- 
cated by a value of 1. 


15 INC Increments the loop count by 
1 if the file is there. 


16 -PARSE Breaks a string into substrings. 
Here we are separating the file 
name from the extension and 
placing them in global vari- 
ables. The global variables 
start with $. Globals were en- 
abled in line 2. .PARSE, is im- 
plemented only for the first 
time through the loop. 


17,18, IF A number of .IF directives that 

19 assemble a line for the later 
MACRO command using 
.SETS. Line 19 uses a GOTO 
to return to LOOP. 


20 .COMP Label that serves as entry 
point for call to subroutine 
MAC. 
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Line Directive Discussion 


21 .GOSUB Calls a subroutine by going to 
a label which marks the entry 
point. In this example the la- 
bel is .MAC: at line 30. 


23 @LINKER.COM Calls a nested indirect control 
file to do the linking. You may 
nest to four levels, including 
the first. Here we pass parame- 
ters by using global variables 
which are available to nested 
control files. 


24 ASK Checks whether the user 
wants to run the new program. 
Like the .ASKS directive, but 
this one accepts only Y or N 
for yes or no. Like .ASKS it 
uses optional parameters in 
the form [default:time]. Time 
is the same as in .ASKS but 
the default is either crue) or 
(FALSE), Which are special sym- 
bols. 


25 FF If false—checks what the user 
typed. If the user typed (RETURN) 
in response to the previous 
questions, IFF will use the 
.STOP directive to stop the 


program. 

26 -OPENA Opens a file for output to 
which records will be ap- 
pended. 

27 DATA Writes a record to the opened 


file. In this example it is a 
keyboard command, RUN, fol- 
lowed by the global variables 
which contain the file name 
and extension of the program 
to run. 


28 .CLOSE Makes the output file perma- 
nent and closes the channel to 
it so that the file can be used 
to pass commands to KMON. 
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Line Directive Discussion 


29 .CHAIN Closes this control file and 
chains to another. 


Practice Using the analysis above as a guide, finish analyzing the 
8—2 subroutine MAC and the two control files US1102.COM and 
US1103.COM (lines 30—69 in figures 18 and 19). 


Practice Modify the file you wrote in practice 8—1 to make it an in- 
8-3 direct control file that: 


Displays the current date and time, then asks if you 
want to set.(or change) either. If you indicate a change, 
it should ask for the new values and set them for you. 


Asks which show option you want and uses the an- 
swer as an option on the SHOW command. 


Asks on which device the files are to be listed and 
which file type you want to see and in what sequence. 
Does not accept illegal categories for the DIREC- 
TORY/ORDER command and lists the directory as 
specified. 


Summary 
ELEMENTS IN INDIRECT COMMAND FILES 


Monitor command is typed one to a line 


! (exclamation point) begins a line of com- 
ment 
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@ (at sign followed by the name of an indi- 
rect command file) begins execution of an 
indirect command file 


ELEMENTS IN INDIRECT CONTROL FILES 


Label marks a specific sequence of commands 
in a file so that IND can easily find it 


IND directive defines labels; assigns values to logical, 
numeric, and string variables; creates and 
accesses data files; controls the flow of 
processes within a file; performs logical 
tests; enables or disables operating modes; 
increases or decreases the value of a 
numeric symbol; or performs operations 
which depend on time 


Monitor command can be typed on a line with an IND 
directive or on a line by itself 


Internal comment _ explains the internal operation of a 
control file, does not appear on the 
terminal when the control file is run 


External comment gives you information when the control 
file is run 


COMMANDS THAT EXECUTE CONTROL FILES 


From monitor level: 
-R IND 
*CONTROL-FILESPEC/OPTION [parameters] 


When SET KMON IND is in effect: 
@CONTROL-FILESPEC/OPTION [parameters] 


To execute command files within control files: 
$@COMMAND-FILESPEC 


References 


Introduction to RT—11. Chapter 16 explains how to create 
and execute an indirect command file. 


RT-—11 System User’s Guide. Chapter 5 explains how to use 
the indirect control file processor (IND) and describes the IND 
directives in detail. 
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Solutions to Practices 


8-1 The indirect command file should contain the following com- 
mands: 
DATE 
TIME 
SHOW CONFIGURATION 
DIRECTORY/ALPHABETIZE DK:*.MAC 


8~—3 The indirect control file could contain the following commands: 


. US1105.COM 

.; SAMPLE SOLUTION TO PRACTICE 8-3 

DATE 

TIME 
.ASK CHT IS DATE AND TIME CORRECT 
IFT CHT .GOTO SHOW 
-ASKS DAT ENTER THE NEW DATE (dd-mmm-yy) 

DATE ‘DAT’ 

.-ASKS TIM ENTER THE NEW TIME (hh:mm:ss:) 

TIME ‘TIM’ 

SHOW: 

.ASKS OPT ENTER THE SHOW OPTION YOU WANT 

SHOW ‘OPT’ 

; You must now specify the files for a directory listing 
-ASKS DEV ENTER THE DEVICE NAME (ddn) 
.-ASKS TYP ENTER THE FILE TYPE (typ) 

; You can select any of the following options for a 

; sorted directed listing. 

; 1. DATE 

; 2. NAME 

; 3. POSITION 

; 4. SIZE 

; 5. TYPE 
.ASKN [1:5:3] SEL ENTER AN OPTION NUMBER 

JF SEL EQ 1 .SETS CAT “DATE”’ 

IF SEL EQ 2 .SETS CAT “NAME” 

IF SEL EQ 3 .SETS CAT “POSITION” 
IF SEL EQ 4 .SETS CAT “SIZE” 

IF SEL EQ 5 .SETS CAT “TYPE” 
DIRECTORY/ORDER:‘CAT’ ‘DEV’:* .‘TYP’ 
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Conserving 
Space with 
Device Support 


RT-11 allows you to use a wide range of devices, both 
physical and logical. This chapter describes device han- 
dlers and discusses the use of the virtual memory handler 
(VM) and the creation of logical disks using the logical disk 
subsetting utility (LD). You will learn to install and re- 
move a device, use the virtual memory device, and create 
and mount logical disks. 
a ee 
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Using Device Handlers 


RT-11 supports a wide range of physical devices most of 
which have a controller that interfaces the device with the 
computer. The controllers for some devices, such as disks, 
support more than one unit or drive. Table 17 shows the 
devices which are supported by RT—11. 

Device controllers need programs called device han- 
dlers to drive them. The RT—11 operating system contains 
a number of device handlers. You will probably not use all 


Table 17. 
Typical RT-11 Physical Devices 
Device Controller Device Type 
Card reader CRi1 CR11 
Clock KW11-L (line clock) 
KW11—P (programmable clock) 
DECtape Il data DL11, DLV11 TU58 
cartridge 
Disk RK11, RKV11 RKO5, RKO5F 
RK611 RKO6, RKO7 
RL11,RLV11,RLV12 RLO1, RLO2 
RQDX1 RD51 
UDA-50 RA80 
Diskette RX11, RXV11 RX01 
RXZ11, RXV21 RX02 
Display Processor VT11 
VS60 
VvSi11 
Line Printer LS11 
LV11 LV11 
LP11, LPV11 all LP-controlled printers (LP05, 
LP25, LP26) 
Magnetic tape TM11, TMA11 TU10, TE16 
RH11 TJU16, TU45, TV77 
TS11 TS11, TSVO5, TU80 
Asynchronous DL11, DLV11 LA120, LA34, LA12 
Terminal DZ11, DZV11 LA100, LQP02, 
Interface MXV11A, MXV11V_-VT100, VT101, VT102, 


VT105, VT125 
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of them, but you can see the handlers which are present on 
your system by issuing the show devices command. 


EXAMPLE 
-SHOW DEVICE S«eturn) 


The system will then produce a list like the follow- | 


ing: 
Device Status CSR Vector(s) 
RK Not installed 177440 220 
DL Not installed 174400 160 
DX Not installed 177170 264 | 
DY Not installed 177170 264 
VM Installed 177572... 250 
LD Installed 000000 000 
DM Resident 177440 210 
LP Not installed 177514 200 
LS Not installed 176500 310 314 
NL Installed 000000 000 


The words Installed and Not installed tell you whether 
or not the device driver is known to RT—11 (that is, whether 
or not it is installed in the monitor tables). You install a 
device by using the following command format: 


INSTALL DEVICE[,DEVICE,...DEVICE] 


Whenever you add a device that is not part of the orig- 
inal configuration to your system, you must install it or make 
it known to RT—11. Typically, the person who manages the 
system is responsible for installing new devices. 


' EXAMPLE 
- INSTALL RK: , DY : RETURN) mee ee 


RK and DY are the permanent device names forthe — 
RKO5 and RX02 drive units. Thus, the INSTALL com- 
mand has made the RKO5 and RX02 elon? devices 
known to RT-11. : 
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When your system was built, there should have been 
some empty spaces, or slots, in the device tables. You can 
find out by typing the SHOW command. 


EXAMPLE _ 
oo _ SHOWRerURN) : | . eae 
oe ae listing displayed might be as follows: eee “| 


TT (Resident) 
DM (Resident) 
oe DMO=DK5. SY: : ae 
MQ CResident): -2 | . a 

LD : cou 

VM eee at ae ae 4 
ENEoeoe oe ae ae 2 
eS free slots. Ss : cs ie oe 


iar iacaneaidaeoeae ooaesenearagae er ertenceacartaeramsater area een caves sananencecasmeeae 


If there are no available slots, you may remove a de- 
vice handler from the table by using the following com- 
mand format: 


REMOVE DEVICE: 


Using Virtual Memory (VM) 


All memory above the 28 Kword boundary is described as 
extended memory. The Virtual Memory handler (VM) is a 
device handler that allows you to use all, or part, of ex- 
tended memory as if it were a disk. Using memory as if it 
were a disk allows you to make use of high speed memory- 
to-memory transfers, instead of the slower disk-to-memory 
transfers. 

Transfers between disk and memory take place under 
the following conditions: 
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1. Nonresident parts of the operating system are 
needed. 


2. Programs which have overlay sections need an over- 
lay. (As mentioned earlier, an overlaid program is 
one in which sections of the program replace each 
other in memory when needed. The process enables 
you to run long programs with less memory.) 


3. Data is needed. 


In SJ and FB systems, you can save time by loading 
the operating system onto the virtual memory device and 
bootstrapping it from there. You must copy onto the virtual 
memory device the monitor and the device handlers for the 
devices you plan to use. 

In SJ, FB, and XM you may transfer overlaid programs 
from the disk into virtual memory and run them. This means 
that the program will run faster. In these three monitors, 
data can be worked on as if it were contained in disk files. 


Installing the VM Device Handler 


To tell RT—11 that you are using the VM device handler, 
you must install VM in the device handler table. To check 
whether or not VM has been installed, you enter the SHOW 
DEVICES command. If VM has not been installed, you can 
install it with the INSTALL command. 


EXAMPLE 


/ INSTALL VM@eturN) 


Binirasnien Sisiadinainndimantaited 


Piaeaninia cacs wnitcininiaai an ina ADR a NR mal ini A NNR in nA HA eC aaa ca i ie in mS S SA NBs A BS Ait ee i Re MMC i IN 


Once you have installed the VM device handler you may 
use it like any other handler. 
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Address 


Virtual memory must be defined to start at a given memory 
address. This address is known as the base address. In each 
of the three types of monitors—SJ, FB, and XM—the vir- 
tual memory device handler has a default base address. In 
SJ and FB, its default base address is 28 Kwords. In the XM 
monitor, VM’s default base address is 128 Kwords. You can 
change the base address of the VM device handler in each 
type of monitor by using the SET VM BASE command: 


SET VM BASE=n 


The value n used in the command is your selected base 
address in octal, divided by 100 octal. For example, the ad- 
dress of the 28K boundary is 160000. Divided by 100 octal 
it becomes 1600. This means that the selected base address 
must be a multiple of 100 octal, and is therefore fixed at a 
32-word boundary. 

Before using the SET BASE=n command you must first 
remove the VM handler, because the amount of memory 
available to VM is computed at the time the handler is in- 
stalled. After setting the base address you can reinstall the 
VM handler. If you change the base address without re- 
moving the handler, the system prints a warning message. 


4 
eg 


ernment nr a ae rcrpe nyn ereteemernceevpemnrres  WPmnt tnmnnn rae corm 


EXAMPLE 


SET vet BASE=1700neum 


sangre ea bie cose oa 


2VM- We Remove, and reinstall. this. handler 


: ‘Your remove ‘the device handler by using the 
a REMOVE command: Ae ae 


LoTR anemcerareem anemone 


REMOVE “Vinererunn) ee OO 
. and reinstall it by using the INSTALL “command: 


| 
| 
| 
: 
: 
| 
: 
) | 
INSTALL ViRETURN) oe ' 
oa 


cor sponaerniceiar meena nest 8 


 —_  ———=F FFF EE SRE A HER EAHA cAI EM WE RI PON i Si i EB 
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Practice The following exercise will acquaint you with the VM han- 
9~—1 dler. If your RT—11 system is equipped with an SJ or FB 
monitor, VM will be installed by default at a base address 
of 1600 (i.e, 160000). On a system with the XM monitor, 
VM will be installed at 10000 (i.e., 1000000) providing that 
amount of memory exists. 


Type: 
SHOW DEVICES return) 
to determine if VM is installed. 


If it is not installed, use the SET command to establish 
the base address at 1700 and install the VM handler 
with the INSTALL command. 


If VM is already installed by default, remove VM, set 
the base address at 1700 (on an SJ or FB monitor) or at 
12000 (on an XM monitor), then install VM. 


Initialize the VM disk with the INITIALIZE command. 


To see the amount of storage you have, type: 


DIR VM(RETURN) 


Use the COPY command to transfer a file to VM: and 
check its directory again. 


Remove VM, set the base address to 1600 (on an SJ or 
FB monitor) or 10000 (on an XM monitor) and verify 
that it is no longer installed. 


Using VM in 18-bit Systems 


If your system uses 18-bit addressing, you can address up 
to 124 Kwords of memory. With the SJ and FB monitors, 
all of the memory between 28 Kwords and the top of mem- 
ory can be used as virtual memory. If you are using the XM 
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monitor, the memory between 28 Kwords and the top of 
memory can be shared between an XM program and virtual 
memory. Figure 20 shows an 18-bit system running the XM 
monitor in 124 Kwords of memory, with the virtual mem- 
ory boundary set at 60K words. 


Using VM in 22-bit Systems 


If your system has 22-bit addressing then you may address 
up to 2044 Kwords of physical memory. This means that 
you can use memory from 28 Kwords to the top of memory 
as virtual memory. With SJ and FB monitors, all of the space 
is available; with the XM monitor, the space between 28K 
and 124K is shared with XM programs. If you use the 128 
Kword boundary for virtual memory, all of the space that 
was previously available to XM programs remains avail- 
able. Figure 21 shows a 22-bit system with the virtual 
memory boundary set at 128 Kwords. 


Using Logical Disks 


The RT—11 directory structure allows you to have 72 file 
entries in each of up to 31 directory segments. This means 
that you may have a maximum of 2232 (72x31) files on any 
disk. Because RT—11 supports disks which will hold up to 
121 million bytes, you can run out of directory space be- 
fore running out of file storage space. The problem can be 
solved with logical disks. Logical disks are files on a phys- 
ical disk, which are handled as if they were file structured 
devices. 

If your organization uses diskettes, you can create log- 
ical disks which have the same capacity as diskettes. You 
can then copy the logical disk to the physical diskette 
without space problems or the need to copy files one at a 
time. 

In addition to having more files on each disk, the use 
of logical disks will permit the creation of sets of files, 
making applications and program development easier to 
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Figure 20. 
Virtual Memory on an 18-bit System 


Up to 124 K-word (18 bit addressing) 


Space available for use by VM handler 

if base address is set at 60 K-word boundary 
60 K-word boundary 

Space available for use by XM program 


28 K-word boundary 


RMON, low 
memory 


Figure 21. 
Virtual Memory on a 22-bit System 


Up to 2044 K-word (22 bit addressing) 


Space available for use by VM handler 
if base address is set at 128 K-word boundary 


128 K-word boundary 


Space available for use by XM program 


28 K-word boundary 


memory 
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control. For example, if a system has an RKO5 disk and two 
RX01 units you could define logical disks of 494 blocks each 
on the RKO5. Each logical disk could then be used as an 
RX01 diskette. The logical disks could hold master copies 
of data for distribution to other systems on RX01, or data 
from RX01 could be copied to a logical disk on the RKO5, 
which gives faster access time. 

To allow you to make use of logical disks, your 
RT—11 system provides the logical disk subsetting utility 
(LD). The logical disk subsetting utility allows you to use 
areas on physical disks as logical disks, each with its own 
directory structure. 


Disks 


Before you can define physical disk space as a logical disk, 
you must create the space you need. Do this by creating a 
file of the necessary size, with the CREATE command. 


EXAMPLE 


3 olf you want a 1 logical disk that is 512 Kbytes i in size an 
(the Capacity of an RX02 diskette) you would give the 
command: 


: E a8 
E eS 
wi ic itive sacaantie rated 


CREATE DM1: DSKFIL. DSK/ALLOC: 1 024¢reruN) ee 


oe : This conimand tells the syatorn to reais a 1024 block 
ee file called DSKFIL.DSK on DM1:. To check that the 
: file has been created you would take a acirectony | list. 
ing: on 


Se DIR DM1: DSKFIL. DSK RETURN) 

: a DSK 1.024 oe 
yal ohiles 1024 Blocks. 
31025 Free blocks — 


_preer nner merino rent neemenera sue meen tn emetvet anni meinen wetness et remem ep 
s 2 ‘ z 5 we ae a 3 


ee re ee ee Sree ee 


ee ee ee ee eA SP di Bi nse A eM a BODES wan Rn se tA 


Once you have created the file that the logical disk will need, 
you can define the logical disk by using DCL commands or 
by using the logical disk subsetting utility (LD) directly. 
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The logical disk subsetting utility allows you to per- 
form the following functions: 


1. Mount and dismount logical disks and connect them 
with files on the physical disk. 


Assign logical names to logical disks. 
Write-lock a logical disk. 
Write-enable a logical disk. 


gag P 2 N 


Verify that the logical disk assignments are correct. 


In our discussion, DCL commands are used ‘to run the LD 
subsetting utility. 

The device handler for logical disks is the program 
LD.SYS, the LD utility program. Make sure that LD is in- 
stalled by using the SHOW DEVICES command. If neces- 
sary, install the device handler with the INSTALL com- 
mand. 


Mounting Logical Disks 


The file type .DSK is the default type for logical disk files. 
When you want to use the file as a logical disk, you can 
connect it with a logical disk unit number by using the DCL 
command MOUNT. 


EXAMPLE 


- ,MOUNT LDO: DM1:DSKFIL.DSKireTurn) 


Pihairs ten naven tatiana Pac 


eg hi act nbn sic iota BR Nie oie el oo ebeR OE 


Although we have made the connection between the 
file and the logical disk number, the logical disk needs a 
disk structure. We must initialize the disk as if it were a 
physical disk. The following sequence of commands shows 
an error message obtained from an invalid command, the 
INITIALIZE command, and a directory listing. 
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EXAMPLE 


DIR. LDO: : (RETURN) 2S , 
 ?DIR- ‘fe Invalid directory nS — 
SINTTOLDO: (RETURN) Sea8 ee 
LDO: (Initializes Aker you sure? Yserun 4 
.DIR LDO: (RETURN) Mees 
0 Files, 0 Blocks sie 
1010 Eres. blocks 


Sor eee romtent are neem nein entertain geezer nean 


Once the logical disk has been initialized, it can be used 
as if it were a physical disk, (except that you cannot boot 
from a logical disk). This means that you can also create a 
logical disk within a logical disk. The following sequence 
shows a file, LITTLE.DSK, being created within LDO: and 
turned into LD1: before a data file, SMALL.DAT, is created 
within it. 


oS ee 
| EXAMPLE _ | 
| .CREATE LDO:LITTLE.DSK/ALLOCATE: 20«neTuaN) ee 
| DIR LDO: LITTLE. DSKcerunn) | a 
Poe LE LEELES DSK: -20 


1oFiles,20 Blocks 

990 Eree blocks 

2RelD: SY S(RETURN) a ees 
= *leDO's LITTLE. DSK/L: ‘e9erumw) os 


eC aes 
.DIR ‘LDO: (RETURN) 
) © PL ITTLE DSK 20P 


41 Files, 20 Bloees 
he 990. Free blocks” 


/INIT LD1: (Return) 

LD1: /Initialize; Are you sure? (RETURN) 
. CREATE ED12: SMALL. DAT/ALLOCATE: LO RETURN 
-DIR LD1: (RETURN) © > 


SMALL.DAT 10 See 
1 Files, 10 Blocks Pe 
2 Free blocks” 


ee i ee rs —— ee——“ =$E Cr 
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Note that the file LITTLE.DSK is shown as protected. The 
default directory size for logical disks is four segments. 


Dismounting Logical Disks 


To dismount and disconnect the logical unit number from 
a file, use the DCL command: 


DISMOUNT LDn: 


Assigning Logical Names to Logical Disks 


You can assign logical names to logical disks in the same 
way that you can assign logical names to physical devices. 
You may make the logical name assignment when you 
mount the logical disk. 


EXAMPLE 


»-MOUNT LDO:DSKFIL.DSK VOL<«RETURN) 


Protecting Logical Disks 


You can specify whether or not to write to a logical disk. 
This is the equivalent of using the write-protect button on 
a physical disk. When you mount a logical disk, the de- 
fault selection is for logical disks to be write enabled. How- 
ever, the MOUNT command takes the option /WRITE or 
/NOWRITE. 


EXAMPLE 


-MOUNT/NOWRITE LDO: LITTLE.DSK «Return 
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You can also change the setting with the SET command: 


SET LDn:WRITE 


or 


SET LDn:NOWRITE 


You can use logical disks to increase the number of files 
stored on a device or to hold a number of related files in 


one areéa. 


Summary 


Logical disk (LD) 
subsetting utility 
Virtual memory 
(VM) 

device handler 


allows you to use areas on physical disks 
as logical disks 


allows you to use all or part of extended 
memory as if it were a disk 


DCL COMMANDS USED WITH DEVICE HANDLERS 


DISMOUNT 


INITIALIZE 


INSTALL 


MOUNT 


MOUNT/NOWRITE 


/WRITE 


REMOVE 


disconnects the logical unit number from a 
file 


clears and sets up the directory of a logical 
disk 


installs the device you specify on the 
monitor table 


connects the file you want to use as a 
logical disk with a logical disk unit 
number 


write-protects the logical disk you are 
mounting 


allows you to write in the logical disk you 
are mounting (the default operation for 
MOUNT) 


removes a device handler from the monitor 
table 


SET LDn:NOWRITE write-protects a logical disk 
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SET LDn:WRITE allows you to write in a logical disk 


SET VM BASE=n_ changes the base address of the VM device 
handler to n (a value you specify) 


SHOW DEVICES lists the handlers that are available on RT— 
11 and whether or not they have been 
installed in the monitor table 


References 


RT-11 System Utilities Manual. Chapter 9 discusses the 
logical disk subsetting utility (LD). 


RT-11 System User’s Guide. Chapter 1 includes a brief dis- 


cussion of device handlers and table 3—1 lists ‘‘Permanent De- 
vice Names.” 


RT-11 Software Support Manual. Section 10.12 describes 
VM. 
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VT100 User Guide 
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Access time The interval between the instant at which data is 
requested from or for a storage device and the instant at which 
the data actually begins moving to or from the device. 


Address_A label, name, or number that designates a location in 
memory where information is stored. 


Alphanumeric The subset of ASCII characters including the 26 
alphabetic characters and the 10 numeric characters. 


ANSI American National Standards Institute. 


Application program A program that performs a function spe- 
cific to the needs of a particular user or class of users. An appli- 
cation program can be any program that is not part of the basic 
operating system. 


Argument A variable or constant value supplied with a com- 
mand that controls the commands’ action, specifically its loca- 
tion, direction, or range. 


ASCII The American Standard Code for Information Inter- 
change; a standard code consisting of eight-bit coded characters 
for upper- and lower-case letters, numbers, punctuation, and 
special communication control characters. 


Assembler A program that translates symbolic source code into 
machine instructions. This program replaces symbolic operation 
codes with binary operation codes and symbolic addresses with 
absolute or relocatable addresses. 
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Assembly language A symbolic programming language that can 
be translated directly into machine language instructions and is 
specific to a given type of control processing unit. 


Assembly listing A listing, produced by an assembler, that 
shows the symbolic code written by a programmer next to a rep- 
resentation of the actual machine instructions generated. 


Asynchronous The type of operation that is triggered by an- 
other event, as opposed to synchronous, or occurring at set time 
intervals. 


Background program A program that runs at a low priority, that 
is, when a higher priority (foreground) program is not using sys- 
tem resources. 


Backup file A copy of a file, created as a precaution against loss 
of the primary file. 


BASIC—11  Beginner’s All-purpose Symbolic Instruction Code, 
an interactive, algebraic programming language that combines 
English words and decimal numbers. This standardized, simple 
language can handle industrial and business applications. 


Binary The number system with a base of two; used by the in- 
ternal logic of all digital computers. 


Binary code A code that uses two distinct characters, usually 
the numbers 0 and 1. 


Bit A binary digit. The smallest unit of information in a binary 
system of notation. It corresponds to a 1 or O and to one digit 
position in a physical memory word. 


Block A group of physically adjacent words or bytes of a size 
that is specific to a device. For input/output operations, the 
smallest addressable unit on a mass storage device. 


Bootstrap § A technique or routine whose first instructions are 
sufficient to start a system of programs that bring an operating 
system into memory. 


BOT Beginning Of Tape, a reflective marker that is applied to 
the backside of magnetic tape and identifies the beginning of the 
magnetic tape’s recordable surface. 


Bottom address The lowest memory address into which a 
program is loaded. 
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Breakpoint A location at which program operation is sus- 
pended to allow operator investigation. 


Buffer A storage area, often a special register or a designated 
area of memory, used to hold information being transferred be- 
tween two devices or between a device or memory. 


Bug A flaw in the design or implementation of a program; a 
problem that can cause erroneous results. 


Byte The smallest memory-addressable unit of information. In 
a PDP—11 computer system, a byte is equivalent to eight bits. 


Call A transfer from one part of a program to another with the 
ability to return to the original program at the point of the call. 


Calling sequence _ A specified arrangement of the instructions 
and data necessary to pass parameters and control to a given sub- 
routine. 


Character A single letter, numeral, or symbol used to repre- 
sent information. 


Clock A device within a computer system that keeps time, 
counts pulses, measures frequency, or generates regular periodic 
signals for synchronization. 


Code _ A system of symbols used to represent data or instruc- 
tions that are executed by a computer. 


Coding The writing of instructions for a computer, using a sys- 
tem of symbols that is meaningful to a computer, an assembler, 
a compiler, or a language processor. 


Command A word, mnemonic, or character that, by virtue of 
its syntax in an input line, causes a computer system to perform 
a predefined operation. 


Command language The vocabulary used by a program or set 
of programs that directs the computer system to perform prede- 
fined operations. 


Command language interpreter The program that translates a 
predefined set of commands into instructions that a computer 
system can interpret. 


Command string A line of input entered into a computer sys- 
tem that generally includes a command, one or more file speci- 
fications, and optional qualifiers. 
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Compile To produce binary code from the symbolic instruc- 
tions of a high-level source language. 


Compiler A program that translates a high-level source lan- 
guage into machine instructions. 


Computer A machine that can be programmed to execute a set 
of instructions. 


Computer program A plan or routine for solving a problem on 
a computer. 


Computer system A data processing system that consists of 
hardware devices, software programs, and documentation that 
describes the operation of the system. 


Concatenation The joining of two or more strings of charac- 
ters to produce a single string. 


Cursor A visible reference point on the display screen which 
shows where the next entry is to be made. 


Configuration A selection of hardware devices, software rou- 
tines, or programs that function together. 


Console terminal A keyboard terminal that acts as the primary 
interface between the computer operator and the computer sys- 
tem. The console terminal is used to initiate direct system oper- 
ations by running software on the computer. 


Constant A value that remains the same throughout a distinct 
operation (compare with variable). 


CPU Central Processing Unit, a hardware unit of a computer that 
includes main memory and the registers and circuits that control 
the interpretation and execution of instructions. 


Crash_ A hardware crash is the failure of a particular device to 
operate; the operation of an entire computer system may be af- 
fected. A software crash is the result of an operating system mal- 
functioning; the system’s protection mechanisms may have failed 
or the software may not have executed correctly. 


Create To open, write data to, and close a file for the first time. 


Cross-reference listing A printed listing that links references 
in a program to specific symbols in a program. It also lists and 
defines all the symbols used in a source program. 
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Data A term used to denote information (in the form of num- 
bers, letters, and symbols) that can be processed by a computer. 


Data base An organized collection of interrelated data items 
that allow one or more applications to process the items, while 
disregarding physical storage locations. 


Data collection To bring data from one or more locations to a 
central location for eventual processing. 


Debug To detect, locate, and correct coding or logic errors in a 
computer program. 


Default The value of an argument, operand, or field assumed 
by a program if a value is not supplied by the user. 


Define To assign a value to a variable or constant. 


Delimiter A character that separates, terminates, or organizes 
elements of a character string, statement, or program. 


Device A hardware unit such as an J/O peripheral, magnetic tape 
drive, or line printer. 


Device control unit A hardware unit that electronically super- 
vises one or more of the same type of devices. It acts as the link 
between the computer and the I/O devices. 


Device handler A routine that services and controls the hard- 
ware activities of an I/O device. 


Device name _ A unique name that identifies each device unit 
on a system. It consists of a two-letter device mnemonic followed 
by an optional device unit number and a colon. For example, the 
common device name for the RLO2 disk drive unit 1 is DL1:. 


Device unit One of a set of similar peripheral devices, an ex- 
ample of a device unit is disk unit 0. 


Digit A character used to represent one of the nonnegative in- 
tegers smaller than the radix (for example, in decimal notation, 
one of the characters 0 to 9; in octal notation, one of the charac- 
ters 0 to 7; in binary notation, one of the characters 0 and 1). 


Direct access See Random access. 


Directive Assembler directives are mnemonics in an assembly 
language source program that are recognized by the assembler as 
commands to control a specific assembly process. 
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Directory A file in the form of a table containing the names of 
and pointers to files on a mass storage volume. 


Directory-structured A storage volume is directory structured 
if the directory at the beginning of the volume contains infor- 
mation (file name, file type, length, and date-of-creation) about 
all the files on the volume. Such volumes include all disks, dis- 
kettes, and DECtapes. 


Disk device An auxiliary storage device on which information 
can be read or written. 


Display A peripheral device used to represent data graphi- 
cally; normally refers to some type of cathode-ray tube system. 


Downtime The time interval during which a device or system 
is inoperative. 


Echo The printing of characters typed by the programmer on 
an I/O device such as a terminal. 


Edit To arrange and/or modify the format of data; for example, 
to insert or delete characters. 


Editor A program that allows the user to enter text into the 
computer and edit it. Editors are language-independent and will 
edit anything in character representation. 


Entry point A location in a subroutine to which program con- 
trol is transferred when the subroutine is called. 


EOT End of Tape, a reflective marker applied to the backside 
of magnetic tape, which precedes the end of the reel. 


Error Any discrepancy between a computed, observed, or mea- 
sured quantity and the specified value or condition. 


Execute To perform an instruction or run a program on the 
computer. 


Extension The synonym used for file type. 


External storage A storage medium other than main memory, 
for example, a disk or tape. 


Field A specified area of a record used for a particular category 
of data. 


FIFO First In/First Out, a data manipulation method in which 
the first item stored is the first item processed. 
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File A logical collection of data that is treated as a unit, occu- 
pies one or more blocks on a mass storage volume, and has an 
associated file name and type. 


File maintenance The activity of keeping a mass storage vol- 
ume and its directory up to date by adding, changing, or deleting 
files. 


File name The alphanumeric character string assigned by a user 
to identify a file. It can be read by both an operating system and 
a user. A file name has a fixed maximum length that is system- 
dependent. (The maximum length in an RT—11 operation system 
is six characters, the first of which must be alphabetic. Spaces 
are not allowed.) 


File specification A name that uniquely identifies a file main- 
tained in any operating system. A file specification generally 
consists of at least three components: a device name, a file name, 
and a file type. 


File-structured device A device on which data is organized into 
files. The device usually contains a directory of the files stored 
on the volume. (For example, a disk is a file-structured device, 
but a line printer is not.) 


File type The alphanumeric character string assigned to a file 
either by an operating system or a user. File types are used to 
identify files having the same format or type. If present in a file 
specification, a file type follows the file name in a file specifica- 
tion, separated from the file name by a period. A file type has a 
fixed maximum length that is system-dependent. The maximum 
in an RT-11 operating system is three characters, not including 
any spaces and excluding the preceding period. 


Flowchart A graphical representation for the definition, anal- 
ysis, or solution of a problem, in which symbols are used to rep- 
resent operations, data, flow, and equipment. 


Foreground § The area in memory designated for use by a high- 
priority program. The program that gains the use of machine fa- 
cilities immediately upon request. 


FORTRAN IV) FORmula TRANslation, a problem-oriented lan- 
guage designed to permit scientists and engineers to express 
mathematical operations in a form with which they are familiar. 
It is also used in a variety of applications, including process con- 
trol, information retrieval, and commercial data processing. 
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Function An algorithm, accessible by name and contained in 
the system software, that performs commonly used operations. 


General register One of eight 16-bit internal registers in the 
PDP-11 computer. These are used for temporary storage of data. 


Global A value defined in one program module and used in 
others. Globals are often referred to as entry points in the module 
in which they are defined as externals in the other modules that 
use them. 


Handler See Device handler. 


Hardware The physical equipment components of a computer 
system. 


Hardware bootstrap A bootstrap that is inherent in the hard- 
ware and need only be activated by specifying the appropriate 
load and start address. 


High-level language A programming language whose state- 
ments are translated into more than one machine language in- 
struction. Examples are BASIC—11 and FORTRAN-IV. 


Indirect file A file containing commands that are processed se- 
quentially, and that could have been entered interactively at a 
terminal. 


Initialize To set counters, switches, or addresses to starting 
values at prescribed points in the execution of a program, partic- 
ularly in preparation for re-execution of a sequence of code. To 
format a volume in a particular file-structured format in prepa- 
ration for use by an operating system. 


Input The data to be processed; the process of transferring data 
from external storage to internal storage. 


Input/Output device A device attached to a computer that makes 
it possible to bring information into the computer or get infor- 
mation out. 


Instruction A coded command that tells the computer what to 
do and where to find the values it needs to work with. A sym- 
bolic instruction looks like ordinary language. Symbolic instruc- 
tions must be changed into machine instructions before they can 
be executed by the computer. 


Interactive processing A technique of user/system commu- 
nication in which the operating system immediately acknowl- 
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edges and acts upon requests entered by the user at a terminal. 
Compare with batch processing. 


Internal storage The storage facilities that form an integral 
physical part of the computer and that are directly controlled by 
the computer; for example, the registers of the machine and main 
memory. 


Interpreter A computer program that translates and executes a 
source language statement before translating and executing the next 
statement. 


Interrupt A signal that, when activated, causes a transfer of 
control to a specific location in memory and breaks the normal 
flow of the routine being executed. 


Job A group of data and control statements that does a unit of 
work. A program and all of its related subroutines, data, and con- 
trol statements is an example. 


Label One or more characters used to identify a source lan- 
guage statement or line. 


Library A file containing routines (macro definitions or relo- 
catable object modules) that can be incorporated into other pro- 
grams. 


LIFO Last In/First Out, a data manipulation method in which 
the last item stored is the first item processed; a push-down stack. 


Linkage The code that connects two separately coded routines 
and passes values and/or control between them. 


Linked file A file whose blocks are joined together by refer- 
ences rather than by consecutive locations. 


Linker A program that combines many relocatable object mod- 
ules into an executable module. It satisfies global references and 
combines program sections. 


Listing The printed copy generated by a line printer or termi- 
nal. 


Load To store a program or data in memory. To place a volume 
on a device unit and put the unit on line. 


Load map A table, produced by a linker, that provides infor- 
mation about a load module’s characteristics; for example, the 
transfer address, the global symbol values, and the low and high 
limits of the relocatable code. 
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Load module _ A program in a format that is ready for loading 
and executing. 


Location An address in storage or memory where a unit of data 
or an instruction can be stored. 


Locked Pertaining to routines in memory that presently can- 
not be swapped or transferred. 


Logical device name _ An alphanumeric name assigned by the 
user to represent a physical device. The name can then be used 
synonymously with the physical device name in all references to 
the device. Logical device names are used in device-independent 
systems to enable a program to refer to a logical device name as- 
signed to a physical device at run-time. 


Loop A sequence of instructions that is executed repeatedly until 
a terminal condition prevails. 


Machine language The language used by the computer when 
performing operations. 


Macro An instruction in a source language that is equivalent to 
a specified sequence of assembler instructions, or a command 
language that is equivalent to a specified sequence of commands. 


Main program The module of a program that contains the in- 
structions at which program execution begins. The main program 
usually exercises primary control over the operations performed; 
it also calls subroutines or subprograms to perform specific func- 
tions. 


Mass storage Pertaining to a device that can store large amounts 
of data that are readily accessible to the computer. 


Memory Any form of data storage, including main memory and 
mass storage, in which data can be read and written. Memory 
usually refers to main memory. 


- Memory image A replication of the contents of a portion of 


memory, usually in a file. 


Mnemonic An alphabetic easy-to-remember representation of a 
function or machine instruction. 


Monitor The master control program that observes, supervises, 
controls, or verifies the operation of a computer system. The col- 
lection of routines that controls the operation of user and system 
programs, schedules operations, allocates resources, performs I/O, 
and so forth. 
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Monitor command An instruction or command issued directly 
to a monitor from a user. 


Monitor command mode The state of the operating system— 
indicated by a period at the left margin—that allows monitor 
commands to be entered from the terminal. 


Mount avolume To logically associate a physical mass storage 
medium with a physical device unit. To place a volume on a 
physical device unit, for example, to place a magnetic tape on a 
magnetic tape drive and put the drive on the line. 


Multiprocessing Simultaneous execution of two or more com- 
puter programs by a computer which contains more than one 
central processor. 


Multiprogramming A processing method in which more than 
one task is in an executable state at any one time, even with one 
CPU. 


Nondirectory-structured Refers to a storage volume that is se- 
quential in structure and therefore has no volume directory at its 
beginning. File information (file name, file type, length, and date- 
of-creation) is provided with each file on the volume. Such vol- 
umes include magnetic tape and cassette. 


Nonfile-structured device A device, such as a line printer or 
terminal, in which data cannot be organized as multiple files. 


Object code _ Relocatable machine language code. 


Object module The primary output of an assembler or com- 
piler, which can be linked with other object modules and loaded 
into memory as an executable program. The object module is 
composed of the relocatable machine language code, relocation 
information, and the corresponding global symbol table defining 
the use of symbols within the module. 


Octal Pertaining to the number system with a radix of eight; 
for example, octal 100 is decimal 64. 


ODT On-line Debugging Technique, an interactive program for 
finding and correcting errors in programs. 


Off-line Pertaining to equipment or devices not currently un- 
der direct control of the computer. 


On-line Pertaining to equipment or devices directly connected 
to and under control of the computer. 
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Operand§ The data that an instruction operates upon. An. oper- 
and is usually identified by an address part of an instruction. 


Operating system The collection of programs, including a 
monitor and system programs, that organizes a central processor 
and peripheral devices into a working unit for the development 
and execution of application programs. 


Operation The act specified by a single computer instruction. 
A program step undertaken or executed by a computer; for ex- 
ample, addition, multiplication, comparison. The operation is 
usually specified by the operator part of an instruction. 


Operation code The part of a machine language instruction that 
identifies the operation the CPU is to perform. 


Operator’s console The set of switches and display lights used 
by an operator or a programmer to determine the status of the 
computer system and to start the computer. 


Option An element of a command or command string that en- 
ables the user to select alternatives associated with the com- 
mand. In the RT—11 operating system, an option consists of a slash 
character (/) followed by the option name and, optionally, a co- 
lon and an option value. 


Output The result of a process; the transferring of data from in- 
ternal storage to external storage. 


Overflow A condition that occurs when a mathematical oper- 
ation yields a result whose magnitude is larger than the hard- 
ware is capable of handling. 


Overlay segment A section of code treated as a unit that can 
overlay code already in memory and be overlaid by other overlay 
segments when called from the root segment or another resident 
overlay segment. 


Overlay structure A program overlay system consisting of a root 
segment and optionally one or more overlay segments. 


Page The portion of a text file delimited by form feed charac- 
ters and generally 50 to 60 lines long. 


Parameter A variable that is given a constant value for a spe- 
cific purpose or process. 


Parity A binary digit appended to an array of binary digits to 
make the sum of all bits always odd or always even. It is used to 
check the validity of data. 
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PDP Programmable Data Processor. 


Peripheral device Any device distinct from the computer that 
can provide input and/or accept output from the computer. 


Physical device An I/O or peripheral storage device connected 
to or associated with a computer. 


Priority § A number, associated with a task, that determines the 
order in which the monitor will process the request for service 
by that task, relative to other tasks requesting service. 


Process A set of related procedures and data that are executed 
and manipulated by a computer. 


Processor In hardware, a data processor. In software, a com- 
puter program that includes the compiler, assembler, translator, 
and related functions for a specific programming language (for 
example, FORTRAN IV processor). 


Program A set of machine instructions or symbolic statements 
combined to perform some task. 


Programmed request A set of instructions (available only to 
programs) that is used to invoke a monitor service. 


Program section A named, contiguous unit of code (instruc- 
tions or data) that is considered as an entity and that can be re- 
located separately without destroying the logic of the program. 


Radix The base of a number system; the number of digit sym- 
bols required by a number system. 


RAM Random-Access Memory, memory that is accessed in such 
a way that the next location from which data is to be obtained is 
not dependent on the location of the data previously obtained. 


ROM _ Read-Only Memory, memory whose contents are not al- 
terable by computer instructions. 


Real-time processing The computation performed while a re- 
lated or controlled physical activity is occurring. The results of 
the computation can be used for guiding the process. 


Record A collection of related items of data treated as a unit; 
for example, a line of source code. 


Relative address The number that specifies the difference be- 
tween the actual address and a base address. 
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Resident Pertaining to data or instructions that are perma- 
nently located in main memory. 


Resource The computational power, programs, data files, stor- 
age Capacity, or a combination of these that are available to a user. 


Restart To resume execution of a program. 


Root segment The segment of an overlay structure that, when 
loaded, remains resident in memory during the execution of a 
program. 


Routine’ A set of instructions arranged in proper sequence to 
cause a computer to perform a desired operation. 


Run _ A single, continuous execution of a program. 
Sector A physical portion of a mass storage device. 


Software The collection of programs and routines associated 
with a computer. Application programs, compilers, and library 
routines are examples. 


Software bootstrap A bootstrap that is activated by loading the 
instructions of the bootstrap and specifying the appropriate load 
and start address. 


Source code Text, usually in the form of an ASCII file, that 
represents a program. Such a file can be processed by the appro- 
priate system program. 


Source language The system of symbols and syntax used to 
describe a procedure that a computer can execute. 


Storage Pertaining to a device into which data can be entered, 
in which it can be held, and from which it can be retrieved at a 
later time. 


String A connected sequence of entities, such as a line of char- 
acters. 


Subpregram A program or a sequence of instructions that can 
be called to perform the same task {though perhaps on different 
data) at different points in a program, or in different programs. 


Subroutine See Subprogram. 


Swapping The process of moving data from memory to a mass 
storage device, temporarily using the empty memory area for an- 
other purpose, and then restoring the original data to memory. 
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Synchronous Pertaining to related events where all changes 
occur simultaneously or in definite timed intervals. 


Syntax The structure of expressions in a language and the rules 
governing the structure of a language. 


System program A program that performs system-level func- 
tions. A program that is part of the basic operating system (for 
example, a system utility program) is a system program. 


System volume The volume on which the operating system is 
stored. 


Table’ A collection of data in a well-defined list. 


Terminal An I/O device, such as a VT100 terminal, that in- 
cludes a keyboard and a display mechanism. In PDP—11 systems, 
a terminal is used as the primary communication device between 
a computer system and a user. 


Toggle To use switches on the computer operator’s console to 
enter data into the computer memory. 


Translate To convert from one language to another. 


Word Sixteen binary digits treated as a unit in PDP—11 com- 
puter memory. 


Write-enabled The condition of a volume that allows infor- 
mation to be written on it. 


Write-protected The condition of a volume that protects the 
volume against information being written on it. 
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DIRECTORY/FULL, 98 
DIR.SAV, 45 
Disk block structure, 36-37 
Disk drives, 4, 5-6 
Disks, 4-6 
See also Logical disks; Storage 
DISMOUNT, 181 
Documentation, 15-16 
Dot prompt, 9-10 
DUMP, 95, 104, 105 
DUP, 94 
DUP.SAV, 45 


EDIT, 55-56, 57 
Editing, 53-73 
deleting, 66-67, 68-69 


on a display terminal, 54-55 
function keys, 59-64 
inserting, 64-66 
keypad editor, 55-58 
restoring, 67 
sections of text, 67-71 
substituting, 69-71 
See also Single line editor; Text 
editing 
Editing commands, 60-61, 71 
EDIT.SAV, 55 
Electronic spreadsheet programs, 14 
ENABLE GLOBAL, 147 
END, 80 
EOL, 63 
Errors, 125-128 
assembly, 126 
in command lines, 125 
compilation, 126 
interpretation, 127 
link, 126 
in program development cycle, 
128 
run-time, 126-127 
EXCLUDE, 101 
EXECUTE, 129-130 
EXIT, 56-57, 58 
Extended Memory (XM) monitor, 10, 
11 
EXTENSION, 98 
External comments, 144 


Factoring, 44 
File examination, 95 
File examination commands, 104- 
106 
File maintenance, utility programs 
for, 94 
File maintenance commands, 45-50, 
95, 107-109 
common options for, 100-103 
COPY, 47-48 
DELETE, 49 
DIRECTORY, 45-47 
PROTECT, 50 
RENAME, 48-49 
UNPROTECT, 50 
File name, 37-41 
changing, 48-49 
erasing, 49 
listing, 45-46 
Files, 36 
copying, 47-48, 96-97 


creation, 55-56, 97-98 
editing, 57-58, 94-95 
erasing, 98-99 
indirect command, 136-140 
indirect control, 140-165 
inspecting, 58, 95 
listing, 45-46, 96 
printing, 103 
protection, 50, 100 
renaming, 48-49, 99-100 
saving, 56-57 
File specifications, 37-44 
device names, 37, 38-41, 42 
factoring, 44 
file types, 37, 41-42, 43 
wildcards, 42-43 
File storage media, 36-37 
See also Disks; Magnetic tape 
File types, 41-42, 43 
FILEX, 94 
FIND, 63-64 
Floppy diskettes. See Disks 
Foreground/Background (FB) 
monitor, 10, 11 
Foreground job, 11 
FORTRAN IV, 121, 122 
FORTRAN IV System Subroutine 
Library, 12 
Function keys: 
editing, 59-64 
single line editor, 77, 78-80, 89-90 


GET OLD, 82-83 
GOLD key, 56-57, 59, 63, 80 


Hardware, 4-6 
minimum requirements for, 5 
optional, 6 
processor, 4 
storage device, 4-6 
terminal, 4 
Hardware manuals, 15, 16 
HELP, 25-28, 59, 78-80 
HOLD SCREEN, 28 


IND directives, 140, 141-143 

IND directive summary, 148-151 

Indirect command files, 136-140 
adding comments to, 138-139 
creation of, 136-137 
executing, 139-140 

Indirect control files, 140-165 
analysis of, 160-165 
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creating, 140-145 
executing, 145-148 
nested, 147, 157 
IND options, 146 
INFORMATION, 102 
Input buffer, 31 
INSPECT, 58 
INSTALL, 179 
Internal comments, 144 
Interpretation errors, 127 
Interpreted language, 122 
Interpreters, 13 


KED. See Keypad editor 
KED.SAV, 55 
Keyboard, 19-32 
correcting mistakes, 24-25 
HELP command, 25-28 
monitor commands, 22-31 
setting time and date, 30-31 
special key combinations, 28-29 
type-head functions, 31-32 
working with, 20-21 
Keyboard layouts, 21, 23 
Keyboard Monitor (KMON), 10 
Keypad editor (KED), 54-73 
commands used with, 60-61, 71 
function keys, 59-64, 71-73 
HELP, 59 
leaving, 56-57 
starting, 55-58 
Keypad functions, 54, 71-73 
Keys, functions of, 20 
KMON, 10 


Labels, 140, 141 

Language processors, 12-13, 119-120 
assemblers, 13 
compilers, 13 
interpreters, 13 
support for, 12 

LEARN, 78 

LIBR, 124 

LINEFEED, 20, 66 

LINK, 123 

Linker, 122-123, 124 

Link errors, 126 

Load module, 122-124 

LOG, 102 

Logical disks (continued ) 
assigning names, 181 
creating, 178-179 
dismounting, 181 
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Logical disks (continued ) 
mounting, 179-181 
protecting, 181-182 

Lowercase type, 106 


Machine code, 114 
MACRO-11, 12, 13 
Magnetic tape, 6, 36 
Manuals, 15-16 
Mass storage medium, 5 

See also Disks; Magnetic tape 
MICRO/PDP-11, 6 
Mnemonics, 5, 38 
Monitor, 8-11 

functions of, 8 

kinds of, 10-11 

parts of, 8-10 


Monitor commands, 22-31, 46, 75-90 


complex, 84 

correcting typing mistakes, 24-25 

editing and issuing, 75-90 

executing, 81-82 

HELP, 25-28 

in indirect control files, 141-143 

retrieving, 82-83 

screening, 88 

selecting, 88-89 

setting date and time, 30-31 

simple, 83-84 

special key combinations, 28-29 
MOUNT, 179, 181 


Nested indirect control files, 147, 
157 
NEWFILES, 99, 101 
NOLEARN, 78 
NOLOG, 102 
NOQUERY, 137-138 
NOREPLACE, 99-100 
NOSCOPE, 28 
NOSCROLL, 28 
NOSWAP, 106 
NOWRITE, 182 


Object code, 13, 119 
Object file, 119-122 
Object libraries, 124 


On-line debugging technique (ODT), 


127 
Operating modes, 151-152 
Operating system, 7-12 
device handlers, 11 
monitor, 8-11 


support for language processors, 
12 
utility programs, 11-12 
OPTION, 95 
Options: 
for file maintenance commands, 
100, 109 
IND, 146 
OUTPUT, 58 
Overlay segments, 130 


Parameters, 146-147 

PDP-11, 4 

Percent sign, 43 

Peripheral interchange program 

(PIP), 94 

PIP.SAV, 45 

POSITION, 102 

PRINT, 103 

Printer, 20 

Processor, 4 

Professional 300 terminal: 
keyboard layout of, 23 
keypad functions on, 54 
SL function keys on, 79 

Program development, 114-132 
creating load module, 122-124 
creating object file, 119-122 
creating source file, 116-119 
cycle of, 114-116 
error detection, 125-128 
increasing efficiency on, 129-131 
writing, 114-116 

Programming languages, 120-122 
assembly, 120-121 
compiled, 121-122 
interpreted, 122 

Program overlays, 130 

Programs. See Software 

PROTECT, 50, 99, 100 


QUERY, 101 
QUIT, 57, 58 


REFRESH, 83 

RENAME, 48-49, 99-100 
REPLACE, 70, 99 

Resident Monitor (RMON), 8-9 
RESORC, 94 

RETURN, 20, 22 

RMON, 8-9 

Root segment, 130 

Run-time errors, 126-217 


SCOPE, 24-25 
Screen editor. See Keypad editor 
SELECT, 68 
SET, 10, 106 
SETDATE, 101 
SET LP LC, 106 
SET SL LEARN, 78 
SET SL OFF, 76 
SET SL ON, 76 
SET USR NOSWAP, 106 
SHOW, 25, 27, 106-107 
SHOW DEVICES, 179 
SINCE, 101 
Single Job (SJ) monitor, 9, 10-11 
Single line (SL) editor, 75-90 
Command String Interpreter, 85-86 
complex commands, 84 
Concise Command Language, 86- 
88 
deleting characters, 80-81 
Digital Command Language, 84-85, 
87-88 
exchanging characters, 81 
executing command lines, 81-82 
function keys of, 77, 78-80 
GOLD, 80 
LEARN, 78-80 
moving cursor, 80 
restoring characters, 80-81 
retrieving commands, 82-83 
screening monitor commands, 88 
selecting commands, 88-89 
simple commands, 83-84 
starting, 76 
stopping, 76 
Software, 6-14 
applications programs, 14 
language processors, 12-13 
RT-—11 operating system, 7-12 
Software manuals, 15, 16 
Sorting programs, 14 
Source code, 114 
Source comparison utility program, 
87, 95 
Source file, 116-119 
Special characters, insertion of, 64- 
65 
SPECINS, 65 
Spreadsheet programs, 14 
SRCCOM, 87, 95 
Storage, 35-51 
file maintenance commands for, 
45-50 
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file specifications for, 37-44 
media for, 36-37 
Storage device, 4-6 
SUBSTITUTE, 70 
SWAP, 81 
Syntax errors, 126 
SYSLIB, 12 
SYSMAC, 12 
SYSTEM, 102 
System function commands, 106-107 
System generation (S), 9 
System prompt, 9-10 
System Subroutine Library 
(SYSLIB), 12 


Tape, magnetic, 6, 36 
Terminal, 4 
Text buffer, 55-56 
Text editing, 64-71 
changing case, 69 
copying text sections, 68-69 
deleting characters, 66 
deleting lines, 66 
deleting text sections, 68-69 
deleting words, 66 
inserting blank lines, 65-66 
inserting special characters, 64-65 
moving text sections, 68-69 
replacing text sections, 70 
restoring text, 67 
substituting text sections, 70 
Time, 30-31 
Time-sharing programs, 14 
TRUNG, 81 
TYPE, 104 
Type-ahead function, 31-32 
Typing. See Keyboard 
Typing mistakes, correction of, 24- 
29 


UNPROTECT, 50, 99, 100 
UNSWAP, 81 
User Service Routine (USR), 10 
Utility programs, 11-12, 93-110 
editing, 55, 94 
file editing and printing com- 
mands, 103-104 
file examination commands, 104- 
106 
file maintenance, 45, 94 
file maintenance commands, 95- 
103, 107-109 
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Utility programs (continued) 
functions of, 94-95, 107 
SRCCOM, 87 
system function commands, 106- 

107 


Version number, 9 
Virtual Memory (VM), 172-176, 177 
VT100 terminal: 

keyboard layout of, 21 


keypad functions on, 54 
SL function keys on, 77 


WAIT, 102 

Wildcards, 41, 42-43 

WORD, 63 

Word processing programs, 14 
WRITE, 181-182 


XM monitor, 11 
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The first of four books in the RT-11 Technical User’s Series, Working with 
RT-11 introduces programmers to the components and features of 
Digital’s single-user, real-time operating system, RT-11. The book 
describes the keyboard functions on both VT100 and Professional 300 
terminals. It examines the commands and utilities needed to edit, 
organize, and maintain files and develop programs from start to finish. 
Practice exercises encourage programmers using RT-11 for the first time 
to sit down at their terminals and become acquainted with the system. 
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